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随 着 计算 机 和 电子 、 通 信 技 术 的 发 展 ， 册 入 式 系统 在 人 们 的 生活 中 变 得 越 来 越 重要 ， 相 关 技 术 发 展 得 越 来 越 快 。 特 别 是 近 几 年 ， 各 类 电子 设备 得 到 极 快 的 发 展 。 很 多 嵌入 式 系统 的 开发 离 不 开 其 核心 基 
础 软件 ， 即 府 入 式 操作 系统 。 本 书 主要 介绍 谨 入 式 操作 系统 内 核 的 概念 与 设计 实现 。 

在 内 容 编排 上 ， 本 书 首先 对 洛 入 式 操作 系统 内 核 各 个 模块 的 概念 进行 讲解 ， 对 可 选 的 设计 方案 进行 比较 分 析 ， 然 后 采用 一 个 具体 的 方案 作为 目标 来 设计 实现 ， 通 过 流程 图 、 图 表 、 示 例 代码 等 详细 演示 
如 何 实现 该 机 制 。 最 后 ， 还 会 通过 实际 应 用 程序 演示 这 些 功能 的 使 用 方法 。 本 书 从 原理 、 设 计 、 实 现 和 应 用 各 个 角度 完整 展示 嵌入 式 操作 系统 内 核 的 相关 功能 。 


全 书 主要 内 容 如 下 : 
第 1 章 介 绍 了 谋 入 式 多 任务 系统 的 基本 知识 。 图 文 并 诚 地 阐述 了 相关 的 重要 概念 。 这 部 分 是 理解 后 面 章节 的 基础 ， 初 学 者 需要 仔细 理解 。 


第 2 章 详细 介绍 了 与 任务 相关 的 概念 、 设 计 和 实现 。 任 务 是 实时 操作 系统 的 重要 概念 ， 本 章 做 了 十 分 详细 的 分 析 。 
第 3 章 详细 介绍 了 实现 IPC 机 制 的 基础 代码 。 本 章 是 第 4~8 章 的 基础 。 全 书 介 绍 了 用 于 任务 间 、 任 务 和 中 断 处 理 函 数 间 的 最 基本 的 几 个 同步 和 通信 机 制 。 


第 4 章 详细 论述 了 信号 量 的 设计 和 实现 。 
第 5 章 详细 论述 了 互 斥 量 的 设计 和 实现 。 
第 6 章 详细 论述 了 邮箱 的 设计 和 实现 。 
第 7 章 详 细 论 述 了 消息 队列 的 设计 和 实现 。 
第 8 章 详细 论述 了 事件 标记 的 设计 和 实现 。 
第 9 章 详细 介绍 了 定时 器 的 机 制 和 设计 实现 。 
第 10 章 分 析 了 内 核 的 移植 代码 ， 着 重 介绍 了 在 意 法 半导体 的 STM32 处 理 器 上 如 何 移植 Trochili RTOS。 读 者 需要 对 基于 ARM Cortex-M3 的 处 理 器 有 一 定 了 解 。 


了 基于 Trochili RTOS 的 以 太 网 协议 应 用 。 通 过 实际 案例 演示 Trochili RTOS 的 使 用 。 
作者 从 事 谍 入 式 工作 多 年 ， 参 与 过 多 款 浴 入 式 处 理 器 的 功能 验证 和 固件 开发 工作 ， 经 常 接触 RTOS， 对 其 有 浓厚 兴趣 。 工 作 之 余党 试 编写 一 些 任务 调度 代码 ， 逐 渐 实现 了 一 套 较 完 整 的 RTOS 内 核 。 这 个 


第 11 章 重点 介绍 
兴趣 爱好 加 深 了 作者 对 谋 入 式 系 统 的 理解 ， 使 得 个 人 能 力 得 到 了 提高 ， 对 本 职工 作 也 有 很 大 帮助 。 目 前 Trochili RTOS 并 不 完美 ， 现 有 很 多 功能 还 需 优 化 ， 作 者 会 逐步 完善 RTOS 的 各 项 功能 。 


由 于 作者 时 间 和 水 平 有 限 ， 书 中 难免 存在 错误 及 不 妥 之 处 ， 敦 请 广大 读者 批评 指正 ， 如 有 问题 ， 可 通过 Trochili RTOS 官 方 网 站 www.ttochili.com 或 者 微 博 www.weibo.comyVtrochili 和 作者 联系 。 


本 书 在 编写 和 出 版 过 程 中 得 到 了 机 械 工业 出 版 社 华章 公司 编辑 们 的 热情 帮助 和 大 力 支持 ， 在 此 一 并 表示 感谢 。 
感谢 北京 航空 航天 大 学 何 小 庆 教 授 对 本 书 的 指导 ， 何 老师 在 全 书 内 容 选取 和 章节 安排 上 给 了 很 好 的 建议 ， 并 对 全 书 做 了 审读 检查 。 感 谢 我 的 朋友 王 文 东 ， 他 对 全 书 内 容 进行 了 详细 的 阅读 并 给 出 了 很 多 


刘 好 明 


改进 意见 。 
本 书 可 作为 广大 从 事 典 入 式 系统 开发 工作 的 工程 师 以 及 其 他 相关 技术 人 员 的 参考 资料 ， 也 可 作为 相关 专业 本 科 生 的 辅助 参考 书 。 
2014 年 4 月 于 北京 


第 1 章 嵌入 式 操作 系统 基础 


为 我 们 在 以 后 各 章 的 谋 入 式 操作 系统 的 内 核 分 析 和 学 习 做 好 准备 。 本 章 的 内 容 并 没有 强调 、 区 分 典 入 式 


介绍 ， 
不 再 介绍 例如 发 展 历史 、 机 制 特点 这 些 基本 知识 。 


多 任务 嵌入 式 操作 系统 相关 的 概念 和 整体 结构 ， 并 对 全 书 涉及 的 重要 知识 做 


本 章 主 要 介绍 
操作 系统 和 通用 操作 系统 的 概念 。 在 这 两 者 之 间 ， 很 多 机 制 是 相通 的 。 另 外 本 章 假设 读者 已 经 对 识 入 式 系统 有 初步 了 解 ， 


















































这 是 最 简 
查询 和 处 理 时 间 是 不 能 确定 的 。 假 刘 
1-1 中 ， 假 如 步骤 1 操作 需要 很 久 ， 那 么 步骤 2 必然 得 不 到 及 时 处 理 


1.1 嵌入 式 软件 系统 结构 
目前 常见 的 嵌入 式 软 件 结构 可 以 分 为 轮 询 系 统 、 前 后 台 系 统 和 多 任务 系统 。 这 些 方案 是 根据 应 用 的 具体 需求 提出 的 ， 各 有 各 自 的 特点 和 适用 的 领域 。 
1.1.1 轮 询 系统 
的 一 种 软件 结构 ， 主 程序 是 一 段 无 限 循 环 的 代码 ， 在 循环 中 顺序 查询 各 个 条 件 ， 如 果 满 足 就 执行 相应 的 操作 。 这 种 方案 的 好 处 是 实现 简单 ， 逻 辑 清晰 ， 便 于 开发 人 员 掌握 。 但 是 每 个 如 
0 前 面 的 操作 时 间 较 长 ， 那 么 后 面 的 操作 必然 会 被 延迟 。 
里 ， 如 果 步 又 2 的 工作 很 重要 或 者 很 紧急 ， 那 么 系统 的 性 能 和 响应 能 力 就 很 差 了 。 

















在 图 





事件 的 











图 1-1 轮 询 系统 结构 


1.1.2 ”前 后 台 系 统 























相对 轮 询 系统 ， 前 后 台 系统 对 外 部 事件 的 处 理 做 了 优化 。 前 后 台 系 统 是 由 中 断 驱动 的 。 主 程序 依然 是 一 段 无 限 循环 的 代码 ， 称 为 后 台 程 序 ， 而 事件 的 响应 则 由 中 断 来 完成 ， 称 为 前 台 程 序 。 在 后 台 程 序 
执行 时 ， 如 果 有 外 部 事件 发 生 ， 则 前 台 的 中 断 程序 会 打 断 后 台 程 序 。 在 完成 必要 的 事件 响应 之 后 ， 前 台中 断 程序 退出 并 通知 后 台 程序 来 继续 操作 。 由 后 台 程序 完成 事件 的 后 继 处 理 ， 比 如 数据 的 分 析 等 操 
作 。 从 代码 功能 上 讲 ， 事 件 的 响应 和 处 理 分 为 了 两 个 部 分 。 因 为 中 断 自身 有 优先 级 和 谋 套 的 功能 。 所 以 优先 级 高 的 事件 能 够 得 到 及 时 响应 。 但 后 台 程序 仍然 需要 按 顺 序 处 理 各 个 事件 的 后 继 事务 。 































































































前 后 台 系 统 演示 如 图 1-2 所 示 : 











中 岂 2 


中 断 1 (3) ”中断 3 


中 晰 4 


如 图 1-2 所 示 ， 在 中 断 源 之 间 有 优先 级 的 概念 。1SR 会 首先 响应 事件 ， 简 单 的 事件 可 以 在 1SR 中 直接 处 理 ， 复 杂 的 情况 下 则 记录 下 必要 数据 和 状态 标记 ， 等 所 有 中 断 处 理 结 束 后 ， 将 由 后 台 主 函数 按 顺 序 处 
理 各 个 事件 。 也 就 是 说 ， 事 件 的 响应 是 支持 优先 级 的 ， 但 事件 的 最 终 处 理 却 是 顺序 的 。 使 用 中 断 来 代替 轮 询 方案 中 事件 的 查询 操作 ， 所 以 相对 轮 询 方案 ， 前 后 台 系 统 对 事件 的 响应 能 力 有 较 大 改善 。 


图 1-2 ”前 后 台 系 统 结构 























1.1.3 ”多 任务 系统 


和 前 后 台 系 统 相 比 ， 多 任务 系统 在 响应 事件 的 时 候 ， 同 样 是 由 多 个 中 断 处 理 程序 完成 的 。 但 是 对 于 事件 的 后 继 操作 则 是 由 多 个 任务 来 处 理 的 。 也 就 是 说 每 个 任务 处 理 它 所 负责 的 事件 。 在 基于 优先 级 的 
多 任务 系统 中 ， 因 为 任务 间 优 先 级 的 关系 ， 优 先 级 高 的 任务 可 得 到 优先 处 理 。 这 样 优先 级 高 的 事件 就 能 及 时 得 到 处 理 ; 在 基于 分 时 机 制 的 多 任务 系统 中 ， 任 务 间 则 按 比例 轮流 占用 处 理 器 。 





多 任务 机 制 如 图 1-3 所 示 。 


图 1-3 ”多 任务 系统 结构 





要 的 ， 那 么 当中 断 2 发 生 时 ， 即 使 其 他 任务 或 者 中 断 正 在 














在 图 1-3 中 ， 中 断 用 来 响应 事件 ， 事 件 的 后 续 操作 则 由 任务 来 完成 。 中 断 和 任务 都 有 优先 级 。 假 如 其 中 中 断 2 和 任务 2 处 理 的 事件 是 紧急 的 或 者 下 
处 理 ， 也 会 被 抢占 ， 最 终 任务 2 会 优先 得 到 运行 机 会 。 























程序 的 设计 ， 系 统 也 变 得 简洁 且 便于 维护 和 扩展 。 对 实时 性 要 求 严格 的 事件 都 














因为 多 任务 操作 系统 允许 将 具体 的 应 用 系统 分 成 若干 个 相对 独立 的 任务 来 管理 ， 所 以 多 任务 操作 系统 的 使 用 可 以 简化 应 
能 得 到 及 时 可 靠 的 处 理 。 不 过 多 任务 操作 系统 自身 将 占用 部 分 处 理 器 、 存 储 器 等 硬件 资源 ， 这 是 引入 多 任务 机 制 的 必要 代价 。 
的 不 同 技术 手段 出 发 ， 可 以 清晰 合理 地 分 析 上 面 介绍 的 这 三 种 软件 结构 方案 ， 可 以 看 到 解 






























































从 事件 和 数据 处 理 的 角度 考虑 ， 可 以 把 整个 应 用 流程 简化 为 事件 响应 和 事件 处 理 两 个 阶段 。 从 这 两 个 阶段 采 
决 问题 的 思路 越 来 越 清晰 ， 结 构 和 层次 越 来 越 合理 。 





表 1-1 是 对 三 种 软件 结构 的 比较 。 


表 1-1 常见 嵌入 式 软件 模型 


轮 询 系统 轮 询 响应 事件 ， 轮 询 处 理事 件 
前 后 台 系 统 后 台 单个 主 程序 实时 响应 事件 ， 轮 询 处 理事 件 
多 任务 系统 实时 响应 事件 ， 实 时 处 理事 件 


领域 。 

















通过 上 面 的 比较 ,我们 可 以 清楚 地 看 到 嵌入 式 软件 结构 上 的 不 同和 发 展 ， 但 这 并 不 是 系统 结构 好 坏 的 标准 。 每 种 方案 都 有 它 产生 的 年 代 、 硬 件 资源 的 发 展 阶段 和 所 适合 的 应 





开发 模型 。 本 书 介绍 的 就 是 嵌入 式 操作 系统 的 核心 部 分 : 谋 入 式 操作 系统 内 核 的 设计 和 实现 。 它 的 主要 功能 包括 : 任务 管理 、 任 务 调度 、 任 务 同 步 、 互 斥 和 通 
户 接口 、 文 件 系统 、TCP/IP 协 议 、 谋 入 式 数据 库 引 党 等 ， 则 可 以 归 为 谋 入 式 操作 系统 内 核 层 之 外 的 功能 模块 。 多 任务 模型 下 RTOS 组 成 如 图 1-4 所 示 。 














多 任务 系统 是 基于 多 任务 操作 系统 的 应 
信 、 设 备 管理 、 中 断 管理 、 时 间 管 理 等 。 而 像 图 形 





























扔 人 式 操 作 系统 


网 络 协议 





图 1-4 多 任务 模型 下 RTOS 组 成 


关于 嵌入 式 操 作 系 统 ， 有 很 多 常见 的 技术 概念 ， 熟 悉 这 些 概念 是 我 们 学 习 嵌 入 式 操作 系统 的 基础 。 本 书后 续 章 节 着 重 分 析 、 设 计 和 实现 一 个 “ 谋 入 式 实时 操作 系统 内 核 ”， 有 了 时 会 使 用 “内 核 ” 这 个 简 
称 。 在 内 容 的 编排 上 ， 会 把 各 种 功能 模块 的 概念 放 在 各 章 起 始 ， 首 先 介绍 其 原理 ， 然 后 分 析 设计 和 实现 。 





1.2 多 任务 机 制 概述 


在 前 面 我 们 介绍 了 多 任务 系统 是 如 何 演化 的 。 和 前 后 台 系 统 相 比 较 ， 多 任务 可 以 理解 为 有 多 个 后 台 程 序 的 前 后 台 系 统 。 每 个 任务 都 专注 于 自己 处 理 的 问题 。 下 面 将 详细 介绍 一 下 和 多 任务 系统 相关 的 一 
些 基本 概念 。 


1.2.1 ”时 钟 节拍 


时 钟 节拍 是 多 任务 系统 的 基础 ， 它 指明 了 把 处 理 器 时 间 以 多 大 的 频率 分 割 成 固定 长 度 的 时 间 片 段 。 作 为 多 任务 系统 运行 的 时 间 尺 度 ， 时 钟 节拍 是 通过 特定 的 硬件 定时 器 产生 的 。 硬 件 定时 器 会 产生 周期 
的 中 断 ， 在 相应 的 中 断 处 理 函 数 中 ， 内 核 代 码 得 以 运行 ， 从 而 进行 任务 调度 和 定时 器 时 间 处 理 等 内 核 工作 。 


处 理 器 的 时 钟 节拍 如 图 1-5 所 示 。 
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时 名 节拍 (1) 时钟 第 铂 《2 时钟 节拍 (3 时钟 第 拍 (4 时 名 各 拍 (5 名 省 拍 ( 


时 间 
T0 Tl T2 13 T4 T3 T6 


图 1-5 ”处理 器 时 钟 节拍 








硬件 定时 器 中 断 的 时 间 间 隔 取决 于 不 同 的 内 核 设计 ， 一 般 是 毫秒 级 的 。 时 钟 节拍 越 快 ， 内 核 函 数 介入 系统 运行 的 几率 就 越 大 ， 时 钟 节拍 中 断 响应 次 数 越 多 ， 内 核 占用 的 处 理 器 时 间 越 长 。 相 反 ， 如 果 时 
钟 节拍 太 慢 ， 则 导致 任务 的 切换 间隔 时 间 过 长 ， 进 而 影响 到 系统 对 事件 的 响应 效果 。 




















辐 1-6 演 示 了 多 任务 系统 中 ， 中 断 处 理 程 序 和 任务 在 时 间 上 的 关系 。 
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图 1-6 ”多 任务 系统 中 的 中 断 和 任务 的 时 间 关 系 











如 图 1-6 所 示 ， 硬 件 定时 器 按照 固定 的 时 间 间 隔 产 生 中 断 ， 然 后 在 时 钟 节拍 中 断 1SR 中 (图 中 以 T 标 记 ) 处 理 内 核 的 工作 。T0~T1 这 段 时 间 是 内 核 占 用 的 时 间 (时 钟 节拍 处 理 程序 ) ，T1~T2 这 段 时 间 是 任 
务 占用 的 时 间 。 而 T0~T2 则 是 一 次 时 钟 节拍 的 全 部 时 间 。 从 图 1-6 中 可 以 看 出 ， 任 务 1 的 本 轮 执 行 占用 了 3 个 时 钟 节拍 。 







































































1.2.2 多 任务 机 制 


在 单 处 理 器 的 计算 机 系统 中 ， 在 某 一 具体 时 刻 处 理 器 只 能 运行 一 个 任务 ， 但 是 可 以 通过 将 处 理 器 运行 时 间 分 成 小 的 时 间 段 ， 多 个 任务 按照 一 定 的 原则 分 享 这 些 时 间 段 的 方法 ， 轮 流 加 载 执行 各 个 任务 ， 
从 而 从 宏观 上 看 ， 有 多 个 任务 在 处 理 器 上 同时 执行 ， 这 就 是 单 处 理 器 系统 上 的 多 任务 机 制 的 原理 ， 如 图 1-7 所 示 。 
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图 1-7 多 任务 机 制 演示 





在 图 1-7 中 ， 任 务 A 和 任务 B 按 照 等 长 时 间 轮 流 占 用 处 理 器 ， 在 单 处 理 器 上 造成 多 个 任务 同时 运行 的 假象。 























另外 ， 因 为 不 同 任务 的 运行 路 径 不 同 ， 在 某 一 时 刻 有 些 任 务 可 能 需要 等 待 一 些 资源 ， 这 时 可 以 通过 某 种 方案 ， 使 当前 任务 让 出 处 理 器 ， 从 而 避免 因为 任务 等 待 资源 而 长 期 占有 处 理 器 而 使 其 他 任务 无 法 
运行 。 这 样 多 任务 机 制 可 以 使 处 理 器 的 利用 率 得 到 提高 ， 并 提高 了 系统 的 处 理 能 
























































在 多 任务 操作 系统 内 核 中 必须 提供 解决 并 发 任务 的 机 制 。 通 用 操作 系统 一 般 以 “进程 ”、“ 线 程 ”等 为 单位 来 管理 用 户 任务 。 在 相关 资料 中 ， 也 会 明确 指出 “进程 ”与 “线程 ”的 区 别 。 但 在 很 多 嵌入 
式 操作 系统 中 ， 并 没有 区 分 进程 和 线程 ， 只 是 把 整个 操作 系统 当 作 一 个 大 的 运行 实体 ， 其 中 运行 着 很 多 任务 。 任 务 通常 作为 调度 的 基本 单位 。 








1.2.3 任务 上 下 文 








任务 可 以 看 作 是 用 户 程序 在 处 理 器 等 硬件 上 的 运行 ， 是 一 个 动态 的 概念 。 任 务 在 处 理 器 上 运行 的 某 一 时 刻 ， 有 它 自己 的 状态 ， 即 处 理 器 所 有 的 寄存 器 的 数据 ， 这 个 叫 作 任 务 的 上 下 文 ， 可 以 理解 为 是 处 
理 器 的 “寄存 器 数据 快照 ”。 通 过 这 些 数 据 ， 操 作 系 统 可 以 随时 打 断 任务 的 运行 或 者 加 载 新 的 任务 ， 从 而 实现 不 同 任务 的 切换 运行 。 














任务 上 下 文 是 跟 处 理 器 密切 相关 的 概念 ， 不 同 的 处 理 器 有 不 同 的 处 理 器 上 下 文 定义 。 比 如 在 Cortex-M3 处 理 器 中 的 寄存 器 如 下 所 述 : 


“ 拥有 R0~R15 寄 存 器 组 。 
" RO~R12 是 通用 寄存 器 。 
“ R13 作为 堆栈 指针 (设置 有 两 个 ,但 在 同一 时 刻 只 有 一 个 指针 起 作用 。) 
“ R14 为 连接 寄存 器 。 
“ R15 为 程序 计数 器 ， 指 向 当前 的 程序 地 址 。 
另外 还 有 特殊 功能 寄存 器 : 
“ 程序 状态 寄存 器 组 (PSR) 
“中断 屏蔽 寄存 器 组 (PRIMASK、FAULTMASK、BASEPRI) 
“ 控制 寄存 器 (CONTROL) 


在 RTOS 设 计 任务 上 下 文 时 经 常会 把 大 部 分 硬件 寄存 器 作为 任务 上 下 文 的 内 容 ， 这 点 在 介绍 操作 系统 移植 时 会 做 详细 介绍 。 


1.2.4 ”任务 切换 


任务 切换 又 叫 作 任务 上 下 文 切换 。 当 操作 系统 需要 运行 其 他 的 任务 时 ， 操 作 系统 首先 会 保存 和 当前 任务 相关 的 寄存 器 的 内 容 到 当前 任务 的 栈 中， 然后 从 将 要 被 加 载 的 任务 的 栈 中 取出 之 前 保存 的 全 部 寄 
存 器 的 内 容 并 加 载 到 相关 的 寄存 器 中 ， 从 而 继续 运行 被 加 载 的 任务 ， 这 个 过 程 叫 作 任 务 切 换 。 


任务 基本 的 切换 过 程 如 图 1-8 至 图 1-11 所 示 。 





假设 系统 中 有 两 个 任务 A、B。 当 前 处 理 器 正在 运行 A 任 务 。 此 时 任务 A 的 栈 顶 在 变量 An 处 : 


任务 A 控制 块 任务 A 栈 内 容 处 理 天 寄存 天 组 任务 B 栈 内 容 任务 B 控制 块 





图 1-8 任务 A 运 行 时 的 上 下 文 情况 


然后 发 生 任务 调度 ， 需 要 首先 保存 当前 的 处 理 器 寄存 器 组 的 内 容 到 任务 A 的 栈 中 : 


任务 A 控制 块 任务 A 栈 内 容 处 理 天 寄存 带 组 任务 B 栈 内 容 任务 B 控制 块 


栈 底 指针 
栈 顶 指针 






保存 当前 寄存 需 组 中 
的 数据 到 任务 A 的 栈 


图 1-9 ”任务 A 上 下 文保 存 


接 下 来 的 操作 就 是 把 保存 在 任务 B 栈 中 的 处 理 器 寄存 器 组 的 内 容 调 入 到 处 理 器 寄存 器 组 中 : 


任务 A 栈 内 容 处 理 需 寄存 天 组 任务 B 栈 内 容 任务 B 控制 块 


栈 底 指针 
栈 项 指针 


任务 A 控制 块 














加 载 保 存在 任务 B 
栈 中 的 寄存 天 组 





图 1-10 任务 B 上 下 文 恢 复 
最 后 ， 处 理 器 开始 继续 执行 任务 B: 


任务 A 控制 块 任务 A 栈 内 容 处 理 天 寄存 需 组 任务 B 栈 内 容 任务 B 控制 块 





任务 B 继续 运行 





图 1-11 任务 B 运 行 时 的 上 下 文 情 况 
这 里 给 读者 留 两 个 问题 : 
“ 保存 在 任务 B 栈 中 的 最 初始 的 寄存 器 组 的 内 容 从 哪里 获得 ? 


“ 保存 在 最 先 执行 的 任务 栈 中 的 寄存 器 组 的 数据 是 如 何 加 载 到 处 理 器 寄存 器 组 的 ? 


1.2.5 “任务 的 时 间 片 和 优先 级 
时 间 片 指 的 是 任务 一 次 投入 运行 ， 在 不 被 抢占 或 者 中 断 的 情况 下 ， 能 够 连续 执行 的 最 长 时 间 以 时 钟 节拍 计数 ) 。 时 间 片 的 长 度 由 具体 操作 系统 规定 ， 有 些 操作 系统 中 不 同 任务 可 以 有 不 同 的 时 间 片 长 
度 ， 或 者 是 在 运行 过 程 中 可 以 动态 改变 时 间 片 长 度 。 





时 间 片 长 度 是 时 钟 节拍 的 整数 倍 ， 如 图 1-12 所 示 。 


时 间 
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图 1-12 ”时 间 片 和 时 钟 节拍 关系 


从 上 图 中 可 以 清楚 地 看 出 ， 任 务 时 间 片 、 时 钟 节拍 、 定 时 器 ISR 之 间 的 时 间 关 系 : 时 间 片 长 度 是 时 钟 节拍 的 整数 倍 ， 一 个 时 钟 节拍 被 定时 器 1SR 和 任务 分 享 。 





: 静态 优先 级 和 动态 优先 级 。 如 





任务 的 优先 级 用 于 安排 系统 中 各 个 任务 的 执行 次 序 ， 它 说 明了 任务 的 重要 性 ， 任 务 越 重 要 ， 它 的 优先 级 应 越 高 ， 越 应 该 获得 处 理 器 资源 。 任 务 优先 级 的 安排 有 两 种 方式 


果 任 务 优先 级 在 运行 的 过 程 中 不 能 改变 ， 则 称 为 静态 优先 级 。 静 态 优先 级 是 在 任务 初始 化 时 决定 的 ; 反之 如 果 任 务 优先 级 是 可 以 改变 的 ， 则 称 为 动态 优先 级 。 











时 间 片 和 优先 级 是 任务 的 两 个 重要 参数 ， 分 别 描述 了 任务 竞争 处 理 器 资源 的 能 力 和 持 有 处 理 器 时 间 长 短 的 能 力 。 这 两 者 同时 是 任务 抢占 的 重要 参数 。 因 任务 时 间 片 运行 完毕 而 引起 的 任务 调度 可 以 理解 
为 时 间 片 调度 ， 而 因为 操作 系统 中 最 高 就 绪 优先 级 的 变化 而 引起 的 调度 则 为 优先 级 调度 。 














1.2.6 “任务 调度 和 调度 方式 








任务 调度 是 操作 系统 的 主要 功能 之 一 ， 在 任务 需要 调度 的 时 候 ， 操 作 系统 会 根据 具体 的 调度 算法 和 策略 选择 合适 的 任务 ， 蔡 换 当前 任务 占有 的 处 理 器 等 硬件 资源 。 根 据 调 度 原 理 的 不 同 ， 任 务 调度 方式 
可 分 为 可 抢占 式 调度 和 不 可 抢占 式 调度 两 类 。 





“ 对 于 基于 优先 级 的 系统 而 言 ， 可 抢占 式 调度 是 指 操 作 系 统 可 以 剥夺 正在 运行 任务 的 处 理 器 使 用 权 并 交 给 拥有 更 高 优先 级 的 就 绪 任 务 ， 让 新 的 任务 运行 。 
“ 对 于 基于 分 时 机 制 的 系统 而 言 ， 每 个 任务 都 能 持续 占用 处 理 器 一 段 时 间 ， 每 轮 时 间 用 完 之 后 操作 系统 就 剥夺 处 理 器 给 别 的 任务 来 执行 。 可 以 把 这 种 调度 方式 理解 为 时 间 引 起 的 抢占 。 


“ 在 不 可 抢占 式 调 度 方 式 下 ， 如 果菜 任务 占有 了 处 理 器 ， 那 它 就 一 直 执行 ， 直 到 它 主动 将 处 理 器 控制 权 让 给 别 的 任务 使 用 。 操 作 系 统 不 会 强制 它 释 放 处 理 器 资源 。 











基于 优先 级 的 可 抢占 式 调度 的 实时 性 好 ， 任 何 优先 级 高 的 任务 只 要 具备 了 运行 的 条 件 ， 即 进入 了 就 绪 态 ， 就 可 以 立即 得 到 调度 和 运行 。 任 务 在 运行 过 程 中 都 随时 可 能 被 比 它 优先 级 高 的 任务 抢占 。 这 种 
方式 的 任务 调度 保证 了 系统 的 实时 性 。 














司 1-13 演 示 了 不 可 抢占 式 操作 系统 中 的 任务 执行 情况 。 例 子 中 有 三 个 任务 需要 运行 。 系 统 的 执行 流程 如 下 : 
“ 在 TO 时 刻 任务 C 得 到 处 理 器 ， 它 开始 执行 。 在 它 执 行 的 过 程 中 ， 任 务 B 和 任务 C 就 绪 ， 但 是 因为 操作 系统 不 支持 抢占 式 调度 ， 所 以 它们 只 好 等 待机 会 。 
' T1 时 刻 任务 C 完 成 操作 ， 主 动 让 出 处 理 器 。 操 作 系 统 选择 任务 B 来 运行 。 


“ T2 时 刻 任务 B 完 成 操作 ， 主 动 让 出 处 理 器 。 操 作 系 统 选择 任务 A 来 运行 。 








“ T3 时 刻 任务 A 完成 操作 ， 主 动 让 出 处 理 器 。 操 作 系统 再 次 选择 任务 C 来 运行 。 


任务 
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1-13 不 可 抢占 式 操作 系统 任务 执行 情况 











对 于 抢占 式 调度 方式 ， 下 面 的 章节 会 有 详细 的 图 示 。 











1.2.7 ”任务 调度 算法 





常见 的 任务 调度 机 制 主要 有 时 间 片 调度 算法 (时 分 式 ) 、 优 先 级 调度 算法 (抢占 式 ) 和 基于 优先 级 的 时 间 片 调度 算法 。 
1. 时 间 片 调度 算法 


时 间 片 调度 算法 指 的 是 操作 系统 先 让 某 个 任务 运行 一 个 时 间 片 〈 多 个 时 钟 节拍 ) ， 然 后 再 切换 给 另 一 个 任务 。 这 种 算法 保证 每 个 任务 都 能 够 轮流 占有 处 理 器 。 因 为 不 是 在 每 个 时 钟 节拍 都 做 任务 调度 ， 
对 处 理 器 资源 的 消耗 又 做 到 了 最 少 。 时 间 片 调度 算法 缺点 是 在 任务 占有 处 理 器 的 时 间 段 内 ， 即 使 是 有 更 紧急 的 任务 就 绪 ， 也 不 能 立刻 执行 它 。 











时 间 片 的 调度 如 图 1-14 所 示 。 
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图 1-14 ”时 间 片 调度 算法 演示 


如 图 1-14 所 示 : 





“ 假设 任务 1 时 间 片 长 度 为 4; 任务 2 时 间 片 长 度 为 8; 任务 3 时 间 片 长 度 为 6。 
“TO 时 刻 任务 1 得 到 运行 。 

: T1 时 刻 任务 1 时 间 片 结束 ， 本 轮 运 行 结束 ; 任务 2 开始 运行 。 

“ T2 时 刻 任务 2 时 间 片 结束 ， 本 轮 运行 结束 ; 任务 3 开始 运行 。 


“T3 时 刻 任务 3 时 间 片 结束 ， 本 轮 运 行 结 束 ; 任务 1 开始 新 一 轮 运行 。 


2. 优先 级 调度 算法 


时 间 


优先 级 调度 算法 指 的 是 操作 系统 总 是 让 具有 最 高 优先 级 的 就 绪 任 务 优先 运行 。 即 当 有 任务 的 优先 级 高 于 当前 任务 优先 级 并 且 就 绪 后 ， 就 一 定 会 发 生 任务 调度 ， 这 种 操作 系统 最 大 限度 地 提升 了 系统 的 实 


时 性 。 


优先 级 调度 算法 如 图 1-15 所 示 。 





图 1-15 只 是 演示 了 在 时 钟 节拍 中 进行 优先 级 调度 的 情况 。 
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图 1-15 ”优先 级 调度 算法 演示 


“ 假设 任务 1 优先 级 为 1， 任 务 2 优先 级 为 4+， 任务 3 优先 级 为 3; 数值 越 大 优先 级 越 高 。 

“TO 时 刻 系统 中 只 有 任务 1 就 绪 ， 所 以 首先 得 到 调度 运行 。 

“T1 时 刻 因为 没有 别 的 任务 就 绪 ， 所 以 任务 1 继续 运行 。 

“Ta 时 刻 任务 2 就 绪 ， 因 为 任务 2 优先 级 高 ， 所 以 它 抢占 任务 1 开始 运行 。 抢 占 发 生 在 T1-T2 时 间 节 拍 之 间 。 
“ T2 时 刻 因为 没有 更 高 优先 级 任务 就 绪 ， 所 以 任务 2 继续 运行 。 

“"T3 时 刻 因为 没有 更 高 优先 级 任务 就 绪 ， 所 以 任务 2 继续 运行 。 

“ Tb 时 刻 任务 2 放弃 了 处 理 器 (比如 任务 被 阻塞 ) ， 任 务 1 得 到 运行 。 


: T4 时 刻 ， 假 设 此 时 在 时 钟 节拍 ISR 里 唤醒 了 任务 3， 因 为 任务 3 优先 级 高 ， 所 以 任务 3 抢占 任务 1。 抢 占 发 生 在 时 钟 节拍 处 。 








“T5 时 刻 ， 任 务 3 继续 运行 。 


优先 级 调度 算法 的 缺点 是 ， 当 最 高 优先 级 任务 在 运行 时 ， 它 将 持续 占有 处 理 器 直到 任务 结束 或 者 阻塞 ， 否 则 其 他 任务 无 法 获得 运行 的 机 会 。 


3. 基于 优先 级 的 时 间 片 调度 算法 


基于 优先 级 的 时 间 片 调度 算法 吸收 了 以 上 两 种 算法 的 优点 ， 同 时 又 解决 了 它们 的 不 足 。 这 种 算法 为 每 个 任务 都 安排 了 优先 级 和 时 间 片 。 在 不 同 优先 级 的 任务 间 采 用 优先 级 调度 算法 ， 在 相同 优先 级 的 任 
务 间 使 用 时 间 片 调度 算法 。 任 务 调度 策略 首先 考虑 任务 的 优先 级 ， 优 先 级 高 的 任务 必定 会 抢占 低 优先 级 的 任务 。 相 同 优先 级 的 任务 则 按照 时 间 片 长 度 比例 共享 处 理 器 时 间 。 这 样 既 保 证 了 能 够 尽快 响应 紧急 


任务 ， 又 保证 相同 优先 级 的 任务 都 有 机 会 轮流 占有 处 理 器 。 


该 算法 如 图 1-16 所 示 。 
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图 1-16 ”基于 优先 级 的 时 间 片 调度 算法 








如 图 1-16 所 示 : 





“ 任务 1 优先 级 为 3， 时 间 片 长 度 为 2 个 时 钟 节拍 ; 任务 2 的 优先 级 为 3， 时 间 片 长 度 为 3; 任务 3 优先 级 为 5， 时 间 片 长 度 为 1 个 时 钟 节拍 ; 任务 4 优先 级 为 1， 时 间 片 长 度 为 2 个 时 钟 节拍 。 


: TO 时刻， 系统 中 只 有 任务 4 就 绪 ， 所 以 任务 4 抢占 得 到 处 理 器 ， 并 运行 。 


“ Ta 时 刻 ， 任 务 2 和 任务 1 就 绪 ， 任 务 2 因 优先 级 抢占 得 到 处 理 器 ， 开 始 运行 。 


“ T2 时 刻 ， 任 务 2 时 间 片 耗 尽 ， 只 好 释放 处 理 器 ; 任务 1 得 到 运行 的 机 会 。 


“IT3 时 刻 ， 任 务 1 时 间 片 耗 尽 ; 任务 2 得 到 运行 的 机 会 。 


“Tb 时 刻 ， 任 务 3 就 绪 ， 发 生 优先 级 抢占 ;任务 3 得 到 运行 的 机 会 。 


“Tc 时 刻 ， 任 务 3 处 理 完 自己 的 工作 ， 主 动 释放 处 理 器 ; 任务 2 得 到 运行 的 机 会 。 


“ Td 时 刻 ， 任 务 2 处 理 完 自己 的 工作 ,主动 释 放 处 理 器 ; 任务 1 得 到 运行 的 机 会 。 





:Te 时 刻 ， 任 务 1 处 理 完 自己 的 工作 ， 主 动 释放 处 理 器 ; 任务 4 得 到 运行 的 机 会 。 


1.2.8 ”任务 状态 


在 多 任务 的 系统 中 ， 任 务 一 般 具 有 多 种 状态 ， 反 映 任务 不 同 的 执行 阶段 。 常 见 任务 状态 主要 有 以 下 3 种 : 
:就绪 状态 : 任务 已 经 获得 除 处 理 器 之 外 的 一 切 需要 的 资源 ， 等 待 任务 调度 。 

* 运行 状态 : 任务 正在 运行 中 ， 获 得 了 所 有 需要 的 资源 。 

“ 等待 状态 : 任务 缺少 某 些 必需 的 运行 条 件 或 资源 而 不 能 参与 任务 调度 。 


不 同 的 RTOS 可 能 有 不 同 的 任务 状态 定义 ， 可 能 会 更 细致 地 定义 一 些 状 态 用 于 管理 各 个 任务 。 


1.3 ”同步 、 互 奈 和 通信 


在 多 任务 系统 中 ， 在 任务 间 、1SR 和 任务 间 必 然 存在 着 处 理 器 交替 抢占 ， 轮 流 执行 的 情况 。 除 此 之 外 ， 这 些 可 执行 对 象 也 存在 着 其 他 关系 ,仔细 观 察 这 些 对 象 ， 它 们 总 是 要 “ 走 走 停 停 、 互 相 照 应 ”， 
也 正 是 多 任务 系统 的 特点 ， 只 有 这 样 设计 系统 才能 使 得 硬件 资源 得 到 最 大 的 利用 。 可 以 把 它们 间 的 关系 总 结 如 下 。 


“ 共享 资源 的 竞争 : 任务 或 者 ISR 访 问 共 享 资源 时 是 互相 竞争 的 ， 只 能 被 一 个 任务 或 者 ISR 访 问 ， 并 且 操作 时 不 能 被 打 断 。 强 调 的 是 “ 互 斥 ”的 概念 。 


可 


四 


运行 同步 : 任务 间或 者 任务 和 ISR 间 互相 协作 ， 按 照 规定 的 路 线 执 行 ， 也 就 是 对 它们 的 执行 步骤 和 顺序 有 和 要求 。 强 调 的 是 “同步 ”的 概念 。 同 步 可 以 是 单 向 的 也 可 以 是 双向 的 。 


“ 数据 通信 : 任务 间或 者 任务 和 ISR 间 的 数据 传输 ， 常 见 的 模式 是 一 方 提供 数据 ， 另 一 方 处 理 数据 ， 共 同 完成 某 些 功能 。 强 调 的 是 “通信 ”的 概念 。 


了 


任务 间 的 数据 传输 ， 可 以 是 直接 的 ， 也 可 以 是 间接 的 。 





“ 在 直接 数据 传输 方式 下 ， 一 个 任务 可 以 把 数据 直接 发 给 指定 的 任务 ， 发 送 过 程 很 明确 地 说 明了 哪个 任务 把 数据 传 给 了 哪个 任务 。 


“ 间接 方式 指 的 是 数据 交互 的 双方 ， 约 定 一 个 数据 缓冲 区 ， 发 送 数据 的 任务 首先 会 把 数据 发 往 该 缓冲 区 ， 然 后 通知 接收 数据 的 任务 则 从 该 缓冲 区 取得 数据 。 从 操作 系统 角度 来 考虑 ， 操 作 系 统 不 关心 
这 些 数据 的 含意 ， 只 当 普通 的 数据 来 处 理 。 

















在 本 书后 面 ， 经 常会 采用 IPC (Inter-Process Communication) 来 代表 以 上 各 种 关系 的 操作 。 从 字面 含义 上 讲 ，IPC 这 个 词 并 不 是 很 恰当 。 常 见 的 IPC 机 制 包括 信号 量 、 邮 箱 、 消 息 队 列 、 事 件 集合 、 
条 件 变量 、 管 道 等 。 
































1.3.1 “任务 等 待 和 唤醒 机 制 























当 任务 在 试图 访问 IPC 对 象 时 ， 经 常会 因为 运行 条 件 不 足 而 失败 ， 被 迫 返 回 或 者 阻塞 在 该 IPC 对 象 的 任务 阻塞 队列 。 而 当 有 任务 释放 资源 从 而 使 得 资源 条 件 可 以 满足 时 ， 操 作 系统 将 会 唤醒 IPC 对 象 上 的 
阻塞 任务 ， 使 得 被 唤醒 任务 继续 运行 。 不 同 的 访问 等 待机 制 和 唤醒 机 制 是 各 种 操作 系统 的 重要 区 别 。 












































于 任务 访问 IPC 对 象 的 等 待机 制 主要 有 三 种 : 








互 


“ 直接 返回 结果 : 任务 直接 返回 访问 结果 ， 成 功 或 者 失败 ; 注意 因为 ISR 不 像 任务 那样 能 够 被 阻塞 ， 所 以 ISR 必 须 采 用 本 模式 。 


“ 阻塞 等 待 模式 : 任务 如 果 访问 IPC 对 象 失败 ， 则 进入 该 IPC 对 象 的 等 待 队列 ， 直 到 明确 得 到 处 理 。 


“ 时 限 等 待 模 式 : 任务 如 果 得 不 到 IPC 对 象 ， 则 进入 等 待 状态 并 开始 计时 。 如 果 在 等 待 期 间 得 到 了 IPC 对 象 则 返回 操作 成 功 ; 如 果 当 计时 结束 时 任务 仍然 没有 成 功 ， 那 么 它 并 不 会 继续 等 下 去 ， 而 是 返回 
失败 的 结果 。 








当 任务 不 能 获得 资源 而 进入 资源 的 等 待 队 列 之 后 ， 如 果 某 个 时 刻 资源 可 用 ， 那 么 操作 系统 就 该 决定 怎么 处 理 这 些 等 待 任务 。 这 就 涉及 操作 系统 任务 唤醒 机 制 。 








操作 系统 唤醒 机 制 主要 有 以 下 三 种 模型 : 


“ 当 资 源 可 使 用 时 ， 唉 醒 该 资源 的 全 部 等 待 任务 。 让 这 些 任务 与 系统 中 的 其 他 任务 平等 竞争 资源 。 这 种 策略 会 使 系统 瞬间 繁忙 ， 在 参与 竞争 资源 的 所 有 任务 中 ， 最 终 只 有 一 个 任务 获取 到 资源 ， 没 有 得 
到 资源 的 任务 将 再 次 进入 资源 的 等 待 队列 。 


“ 将 该 资源 等 待 队列 中 的 一 个 合适 的 任务 唤醒 。 这 个 任务 将 和 系统 中 可 能 访问 该 资源 的 其 他 任务 一 起 竞争 这 个 资源 。 如 果 这 个 任务 最 终 没 有 竞争 到 资源 ， 它 会 再 次 进入 该 资源 的 等 待 队 列 。 


“ 操作 系统 从 等 待 队列 中 找到 一 个 最 佳 的 任务 并 立刻 把 资源 交 给 它 ， 这 样 该 任务 直接 从 释放 资源 的 那个 任务 那里 获得 资源 。 











目前 主流 嵌入 式 操作 系统 都 采用 第 三 种 方案 。 








1.3.2 任务 互 斥 和 优先 级 反 转 























在 系统 中 ， 有 些 资源 必须 是 独占 使 用 的 ， 多 个 任务 对 这 样 的 资源 的 并 发 访问 将 导致 错误 的 发 生 。 一 般 来 说 ， 对 需要 独占 使 用 的 资源 必须 使 用 互 斥 方法 将 对 其 的 并 发 访问 串 行 化 。 





























在 优先 级 多 任务 系统 中 引入 互 斥 方案 ,会 导致 任务 优先 级 反 转 的 问题 : 假如 某 时 低 优先 级 的 任务 占有 资源 ， 然 后 又 有 高 优先 级 的 任务 申请 资源 ， 但 因为 不 能 满足 而 被 挂 起 了 ， 即 低 优先 级 任务 阻塞 了 高 
优先 级 任务 的 运行 。 假 如 这 时 又 有 一 个 中 优先 级 任务 ， 那 么 它 会 把 低 优先 级 任务 抢占 。 最 终 高 优先 级 任务 会 间接 地 被 中 优先 级 任务 抢占 了 。 这 种 现象 叫 作 优 先 级 反 转 。 举 例 说 明 : 




















假如 A、C、D 三 个 任务 优先 级 从 高 到 低 排列 ， 任 务 A 和 (C 共 享 互 斥 信号 量 R， 如 果 某 一 时 刻 任务 C 已 经 获得 互 斥 信号 量 R， 而 任务 A 此 时 尝试 占用 R， 那 么 任务 A 会 因为 得 不 到 R 而 阻塞 在 R 的 任务 等 待 队列 
中 。 再 假设 此 时 任务 D 因 为 优先 级 高 于 任务 C 从 而 抢占 了 C， 进 而 长 期 占有 处 理 器 资源 ， 那 么 就 相当 于 低 优先 级 的 任务 D 间 接 阻塞 了 高 优先 级 任务 A 的 运行 。 




















这 个 过 程 可 以 用 图 1-17 来 说 明 。 


任务 
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图 1-17 优先 级 反 转 














.TO 时 刻 ， 任 务 C 处 于 运行 状态 ， 运 行 过 程 中 ， 任 务 C 获 得 了 共享 资源 R。 


“ T1 时 刻 ， 任 务 A 就 绪 。 由 于 任务 A 优先 级 高 于 任务 C， 所 以 它 抢占 了 任务 C， 任 务 A 被 调度 执行 。 
“ T2 时 刻 ， 任 务 A 需 要 共享 资源 R， 但 R 被 更 低 优先 级 的 任务 C 所 拥有 ， 所 以 任务 A 被 阻塞 等 待 该 资源 。 任 务 C 得 到 执行 。 
“T3 时 刻 ， 此 时 任务 DD 就 绪 ， 由 于 任务 DD 优先 级 高 于 任务 C， 所 以 它 抢 占 了 任务 C， 任 务 D 被 调度 执行 。 


从 整个 流程 上 看 ，T3 时 刻 ， 高 优先 级 任务 A 被 低 优先 级 任务 DI 间接 地 抢占 了 。 此 时 优先 级 最 高 的 任务 A 不 仅 要 等 任务 C 运 行 完 ， 还 要 等 优先 级 低 的 任务 D 运 行 完 才能 被 调度 ， 如 果 任 务 D 和 任务 C 需 要 执行 
很 长 时 间 ， 那 么 任务 A 的 执行 就 不 能 得 到 保证 ， 整 个 系统 的 实时 性 能 很 差 。 


优先 级 反 转 现象 中 对 基于 优先 级 调度 的 实时 系统 有 很 大 的 影响 。 在 基于 优先 级 调度 的 系统 中 ， 处 理 器 资源 是 按照 优先 级 分 配给 任务 的 ， 就 绪 的 高 优先 级 任务 必须 实时 获得 处 理 器 。 系 统 中 的 各 种 资源 ， 
如 果 采 用 按照 任务 优先 级 分 配 的 原则 ， 那 么 高 优先 级 的 任务 应 该 是 首先 被 考虑 的 。 优 先 级 反 转 的 问题 将 打 乱 这 些 原 则 。 

















[ea 优先 级 反 转 是 由 来 已 久 的 问题 ， 自 从 出 现 多 任务 系统 后 ， 就 一 直 困 扰 着 开发 人 员 ， 很 典型 的 一 个 优先 级 反 转 引起 的 案例 是 在 1997 年 7 月 美国 探 路 者 火星 车 (Pathfinder) 发 生 的 在 火星 表面 不 停 重启 的 故 
障 ， 读 者 如 果 有 兴趣 可 以 自己 去 查阅 相关 资料 。 


1.3.3 ”优先 级 天 伦 板 和 优先 级 继承 















































优先 级 反 转 问题 的 核心 原因 在 于 共享 资源 的 访问 规则 ， 即 共享 资源 只 能 被 一 个 任务 占用 ， 被 占用 后 其 他 任务 不 能 强制 使 用 这 个 资源 。 在 优先 级 反 转 问题 上 ， 高 优先 级 任务 被 低 优先 级 任务 阻塞 是 必定 
的 ， 但 被 中 优先 级 任务 阻塞 则 是 很 无 奈 的 。 为 了 避免 因为 中 优先 级 任务 挟持 低 优先 级 任务 从 而 阻塞 高 优先 级 任务 的 现象 ， 可 以 采用 一 些 必要 的 算法 。 





























有 两 种 经 典 的 防止 优先 级 反 转 的 算法 : 


“ 优先 级 继承 策略 (Priority inheritance) : 当 一 个 任务 占有 了 资源 并 且 随 后 阻塞 了 其 他 申请 该 资源 的 任务 时 ， 该 任务 将 临时 改变 它 的 优先 级 为 所 有 申请 该 资源 的 任务 中 的 最 高 优先 级 ， 并 以 这 个 临时 优先 
级 在 临界 区 执行 。 当 任务 释放 资源 后 ， 则 恢复 它 原 有 的 优先 级 。 从 行为 上 看 ， 占 有 资源 的 任务 的 优先 级 将 是 “水 涨 船 高 ” 式 的 多 次 改变 ， 因 为 它 的 优先 级 最 高 ， 所 以 它 不 会 被 曾经 比 它 优先 级 高 的 那些 任务 
抢占 。 操 作 系统 从 优先 级 角度 安排 它 尽 快 执行 ， 尽 快 释放 资源 ， 但 是 这 样 做 操作 系统 却 牺 牲 了 中 等 优先 级 任务 的 调度 机 会 。 


“ 优先 级 天 花 板 策略 (Priority ceilings) : 将 申请 (占有 ) 资源 的 任务 的 优先 级 提升 到 可 能 访问 该 资源 的 所 有 任务 的 最 高 优先 级 (这 个 最 高 优先 级 称 为 该 资源 的 优先 级 天 花 板 ) 。 


1. 优先 级 继承 策略 





优先 级 继承 策略 如 图 1-18 所 示 。 


优先 级 











| | 任务 CIC4)1 任务 A(4) | | | 
ES P| OO 





TO0 Tl 2 Ta 1T3 T4 T5 T6 时 间 








1-18 优先 级 继承 策略 








“TO 时 刻 ， 只 有 任务 C 处 于 运行 状态 ， 在 运行 过 程 中 ， 任 务 C 得 到 共享 资源 R。 
 T1 时 刻 ， 任 务 B 抢 占 任务 C， 并 尝试 获得 资源 R， 因 为 优先 级 继承 的 原因 ， 任 务 C 的 优先 级 被 提升 到 任务 B 的 优先 级 ; 任务 B 被 阻塞 。 


“ T2 时 刻 ， 任 务 A 抢占 任务 C， 并 尝试 获得 资源 R， 因 为 优先 级 继承 的 原因 ， 任 务 C 的 优先 级 被 提升 到 任务 A 的 优先 级 ; 任务 A 被 阻塞 。 


ee 


: 在 Ta 时 刻 ， 任 务 D 就 绪 ， 但 因为 此 时 任务 C 的 优先 级 已 经 被 提升 并 且 比 任务 DD 优先 级 高 ， 所 以 任务 D 不 能 抢占 任务 C， 任 务 C 继 续 运行 。 


“ T3 时 刻 ， 任 务 C 释 放 资 源 ， 它 的 优先 级 恢复 到 原 有 优先 级 。 任 务 A 得 到 资源 ， 并 因为 优先 级 原因 抢占 任务 C。 


“ T4 时 刻 ， 任 务 A 释放 资源 ， 结 来 运行 。 任 务 B 得 到 资源 。 但 此 时 因为 任务 DD 优先 级 高 于 任务 B， 所 以 任务 DD 开始 运行 。 








“ T5 时 刻 ， 任 务 D 结 束 运行 ， 任 务 B 开 始 执行 。 


2. 优先 级 天 花 板 策略 





优先 级 天 花 板 策略 如 图 1-19 所 示 。 
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图 1-19 优先 级 天 花 板 策略 


“T1 时 刻 ， 任 务 C 得 到 共享 资源 R， 因 为 优先 级 天 花 板 策略 的 原因 ， 任 务 C 的 优先 级 提升 到 全 部 可 能 访问 该 资源 的 任务 的 最 高 优先 级 。 


"Ta 时 刻 ， 任 务 A 抢占 任务 C 执 行 ， 随 后 尝试 获得 资源 R， 但 是 失败 并 阻塞 。 任 务 C 继 续 运 行 。 


' Tb 时 刻 ， 任 务 B 就 绪 ， 但 是 因为 任务 C 优 先 级 更 高 ， 所 以 只 能 等 待 执行 。 


“ T2 时 刻 任务 C 释 放 资 源 R， 任 务 A 得 到 资源 R。 因 为 使 用 优先 级 天 花 板 策略 ， 任 务 C 优 先 级 恢复 到 原 有 优先 级 。 任 务 A 抢 占 任务 C 开 始 运行 。 


“IT3 时 刻 ， 任 务 A 结 束 运 行 。 任 务 B 开 始 运行 。 








测 


“IT4 时 刻 ， 任 务 B 结 束 运行 。 任 务 C 开 始 继续 运行 。 





优先 级 继承 策略 对 任务 执行 流程 的 影响 相对 较 小 ， 因 为 只 有 当 高 优先 级 任务 











请 已 被 低 优先 级 任务 占有 的 共享 资源 这 一 事实 发 生 时 ， 才 提升 低 优先 级 任务 的 优先 级 。 而 天 花 板 策略 是 谁 占有 就 直接 升 到 





最 高 。 形 象 地 说 ， 优 先 级 继承 策略 是 “水 涨 船 高 ”， 而 优先 级 天 花 板 策略 则 是 “一 次 到 位 ”。 


1.4 中 断 机 制 























中 断 机 制 是 处 理 器 的 重要 基础 设施 ， 用 来 应 对 各 种 事件 的 响应 和 处 理 。 当 外 设 或 者 处 理 器 自身 有 事件 发 生 时 ， 处 理 器 会 暂停 执行 当前 的 代码 ， 并 转向 处 理 这 些 中 断 事务 。 在 处 理 器 与 外 设 间 的 交互 大 多 



































采用 中 断 来 完成 ， 中 断 系统 能 极 大 提高 系统 的 效率 。 

















发 出 中 断 请 求 的 来 源 叫 作 中 断 源 。 根 据 中 断 源 的 不 同 ， 可 以 把 中 断 分 为 以 下 三 类 : 


1. 外 部 中 断 


外 部 中 断 是 指 由 系统 外 设 发 出 的 中 断 请 求 ， 如 串口 数据 的 接收 、 键 盘 的 敲 击 、 


请 求 。 


2. 内 部 中 断 


打印 机 中 断 、 定 时 器 时 间 到 达 等 。 外 部 中 断 大 多 是 可 以 屏蔽 的 ， 程 序 可 以 根据 具体 需要 ， 通 过 中 断 控制 器 来 屏蔽 这 些 中 断 


内 部 中 断 指 因 处 理 器 自身 的 原因 引起 的 异常 事件 ， 如 非法 指令 、 总 线 错 误 〈 取 指 ) 或 者 运算 出 错 ( 除 0) 等 。 内 部 中 断 基本 是 不 可 屏蔽 的 中 断 。 


3. 软件 中 断 


软件 中 断 是 一 种 特殊 的 中 断 ， 它 是 程序 通过 软件 指令 触发 的 ， 从 而 主动 引起 程序 流程 的 变化 。 比 如 在 用 户 级 运行 的 程序 在 菜 时 刻 需要 访问 处 理 器 中 受到 保护 的 寄存 器 ， 则 可 以 通过 软件 中 断 进入 系统 


级 ， 实 现 权 限 的 提升 。 














在 不 同 的 处 理 器 中 ， 以 上 三 种 中 断 可 能 有 不 同 的 名 称 或 者 概念 ， 但 从 技术 层面 划分 ， 各 种 中 断 基本 都 属于 这 三 类 。 所 以 读者 不 必 纠结 于 不 同 处 理 器 上 的 具体 称谓 。 比 如 在 ARM Cortex-M3 内 核 中 ,将 








软件 中 断 和 内 部 中 断 统称 为 异常 ， 把 外 部 中 断 称 为 中 断 ， 并 通过 中 断 向 量 表 把 这 些 中 断 和 异常 组 织 在 一 起 ， 如 表 1-2 所 示 。 











表 1-2 中断 向 量 表 


加 
JI 
耻 
了 局 


0 N/A 没有 异常 

1 复位 系统 复位 

2 NMI 不 可 屏蔽 中 断 

3 所 有 不 被 处 理 的 fault 都 统一 引起 硬 fault 
4 内 存 管 理 fault 

: 

6 用 法 fault 

7-10 保留 


SVC Call 由 系统 调用 指令 SVC 引起 


bs 
一 


编号 类 型 介绍 
2 调试 器 

13 保留 

14 PendSV 系统 级 中 断 服务 


15 SysTick 系统 时 钟 中 断 
16 IRQ#O 0 号 外 中 断 


17 IRQ#1 1 号 外 中 断 


hk 
mn 
nn 


IRQ#255 255 号 外 中 断 














Cortex-M3 在 内 核 中 拥有 一 个 异常 处 理 系统 ， 用 来 支持 各 种 系统 异常 和 外 部 中 断 。 其 中 编号 为 1~ 15 的 对 应 系统 异常 ， 其 余 则 是 外 部 中 断 。 








1.4.1 中断 流程 概述 





不 同 处 理 器 上 的 中 断 处 理 流程 大 致 是 相同 的 ， 但 也 有 些 细微 差别 。 所 以 这 里 我 们 只 介绍 中 断 大 概 的 几 个 阶段 ， 如 图 1-20 所 示 。 
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1-20 ”中断 的 几 个 阶段 





， 用 户 程序 正在 执行 ， 此 时 有 外 部 设备 产生 中 断 请 求 。 


， 处 理 器 开始 处 理 外 部 中 断 ， 保 存 中 断 现场 。 


， 处 理 器 开始 执行 中 断 处 理 器 函数 。 


， 用 户 中 断 处 理 函 数 结束 ， 处 理 器 开始 恢复 中 断 现 场 。 


， 被 中 断 的 用 户 程序 继续 执行 。 





其 中 从 T0 时 刻 中 断 产生 到 T1 时 刻 处 理 器 开始 处 理 中 断 的 这 段 时 间 称 为 中 断 延 时 ， 这 个 和 处 理 器 是 相关 的 。 也 就 是 说 ， 外 部 中 断 并 不 是 一 发 生 就 被 立刻 处 理 的 。 


从 T1 时 刻 开 始 ， 处 理 器 开始 处 理 中 断 ， 一 般 来 说 ， 此 时 最 重要 的 工作 就 是 保留 中 断 现场 ， 以 保证 能 够 正确 恢复 任务 的 执行 。 中 断 现 场 主要 的 内 容 就 是 处 理 器 上 下 文 ， 而 数据 一 般 是 保存 到 某 个 具体 的 栈 
中 。 这 个 同样 与 处 理 器 相关 。 

















T2 时 刻 处 理 器 就 可 以 正常 去 执行 用 户 定义 的 中 断 处 理 函 数 。 而 从 T0 到 T2 这 段 时间 被 称 为 中 断 响应 时 间 。 











T3 时 刻 中 断 处 理 函 数 运行 完毕 ， 通 过 特殊 的 指令 或 者 流程 ， 处 理 器 从 栈 中 开始 恢复 本 次 中 断 的 现场 。T3 到 T4 的 时 间 称 为 中 断 恢 复 时 间 。 





以 上 是 对 流程 最 简单 的 介绍 ， 其 实 中 断 流程 还 有 很 多 细节 问题 ， 比 如 中 断 让 套 的 问题 ， 处 理 器 保存 上 下 文 的 问题 ，RTOS 内 核 介 入 中 断 处 理 的 问题 。 











1.4.2 ”中断 优先 级 


当 几 个 中 断 同 时 产生 时 ， 首 先 响应 哪个 中 断 是 个 值得 考虑 的 问题 。 当 前 绝 大 多 数 的 处 理 器 都 支持 中 断 优 先 级 的 概念 ， 也 就 是 说 ， 为 不 同 的 中 断 源 配置 不 同 的 优先 级 ， 优 先 级 是 固定 的 或 者 可 以 通过 软件 
配置 。 当 多 个 中 断 同时 产生 (或 者 说 需要 处 理 ) 时 ， 首 先 响应 优先 级 高 的 中 断 ， 这 样 就 能 优先 处 理 高 优先 级 的 事件 。 不 同 的 处 理 器 可 能 有 不 同 的 中 断 优先 级 策略 。 














1.4.3 ”中 断 族 套 





与 中 断 相关 的 另 一 个 重要 的 问题 是 中 断 谋 套 。 当 处 理 器 正在 处 理 某 个 中 断 时 ， 如 果 有 其 他 中 断 发 生 ， 那 么 就 得 仔细 考虑 如 何 处 理 新 的 中 断 。 对 于 简单 的 处 理 器 来 说 ， 可 能 本 身 并 不 支持 中 断 谋 套 ， 在 中 
断 响应 阶段 就 把 中 断 给 关闭 了 。 而 当前 大 多 数 的 处 理 器 是 支持 中 断 庶 套 的 ， 方 案 基本 是 结合 中 断 优先 级 的 谋 套 方式 ， 原 则 是 : 











“ 高 优先 级 中 断 可 以 抢占 低 优先 级 中 断 。 
“ 同 级 中 断 不 可 抢占 (包括 自身 ) 。 


:不 能 被 立刻 响应 的 中 断 会 被 悬挂 (Pending) ， 等 待 高 优先 级 中 断 退 出 后 才 执 行 。 





中 断 谋 套 行为 的 如 图 1-21 所 示 。 
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中 断 1 发 生 中 断 2 发 生 中 断 2 结束 中 断 1 结束 


图 1-21 中 断 庶 套 行为 


1.4.4 ”中断 时 序 

















在 前 面 我 们 介绍 了 中 断 的 基本 流程 ， 结 合 前 面 章节 介绍 的 嵌入 式 软件 结构 和 实时 操作 系统 的 抢占 方式 ， 我 们 来 具体 分 析 一 下 中 断 时 序 的 问题 。 





首先 是 前 后 台 系 统 的 中 断 时序 ， 如 图 1-22 所 示 。 
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图 1-22 





轮 询 处 理事 务 。 











这 也 说 明了 前 后 台 的 特点 : 实时 响应 事件 、 


可 以 看 出 前 后 台 系统 的 中 断 时 序 很 简单 ， 


司 1-23 演 示 了 不 可 抢占 式 操作 系统 的 中 断 处 理 流程 。 
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图 1-23 不 可 抢占 式 操 作 系 统 的 中 断 处 理 流程 








可 以 看 出 不 可 抢占 式 多 任务 系统 的 中 断 时 序 和 前 后 台 系 统 的 中 断 时 序 很 相似 ， 需 要 注意 的 是 前 后 台 系统 只 有 一 个 后 台 任 务 ， 所 有 中 断 打 断 的 都 是 这 个 唯一 的 任务 。 而 不 可 抢占 式 多 任务 系统 则 有 很 多 任 


可 能 被 中 断 打 断 。 


图 1-24 演 示 了 可 抢占 式 操作 系统 的 中 断 处 理 流程 。 





务 ， 每 个 任务 都 
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如 图 1-24 所 示 : 


“TO 时 刻 ， 用 户 任务 正在 执行 ， 此 时 有 外 部 设备 产生 中 断 请 求 。 


“ T1 时 刻 ， 处 理 器 开始 处 理 外 部 中 断 ， 保 存 中 断 现场 。 
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“ T2 时 刻 ，RTOS 介 入 ， 进 行 中 断 预 处 理 ， 记 录 当 前 中 断 嵌 套 深 度 ， 查 找 用 户 登 记 的 中 断 处 理 程序 。 
“ T3 时 刻 ， 处 理 器 开始 执行 中 断 处 理 器 函数 。 
“ T4 时 刻 ，RTOS 介 入 ， 进 行 中 断 退 出 处 理 ， 如 果 当 前 中 断 是 所 有 座 套 中 断 的 最 后 一 个 ， 则 进行 任务 调度 处 理 ， 此 时 可 能 发 生 任务 切换 的 准备 。 
“T5 时 刻 ， 处 理 器 开始 恢复 中 断 现场 ， 此 时 恢复 的 现场 未 必 是 T1 时 刻 保存 的 任务 现场 ， 而 是 在 T4 时 刻 选择 的 最 高 就 绪 优 先 级 的 任务 。 
“ T6 时 刻 ， 如 果 没 有 进行 任务 调度 和 切 的 ， 则 被 中 断 的 用 户 任务 继续 执行 ， 如 图 1-24 所 示 。 如 果 进行 了 任务 切换 ， 则 如 图 1-25 所 示 。 
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这 里 需要 解释 一 下 为 什么 RTOS 介 入 可 抢占 式 操作 系统 的 中 断 流程 。 





T0 Tl 12 T3 T4 


图 1-25 ”进行 任务 切换 

















TS T6 


因为 在 可 抢占 式 操作 系统 中 ， 当 从 中 断 返 回 时 会 处 理 任务 抢占 的 问题 ， 所 以 在 每 次 中 断 进入 时 都 要 对 中 断 说 套 计数 做 加 法 ;， 在 每 次 中 


断 退 出 时 都 要 对 中 断 谋 套 计数 做 减法 ， 然 后 再 继续 检查 中 断 谋 套 计数 是 否 为 0%， 如 果 是 ， 则 说 明 中 断 彻底 退出 了 ， 需 要 进行 任务 调度 的 处 理 。 这 些 操作 都 是 由 RTOS 完 成 的 。 而 不 可 抢占 式 操作 系统 则 没有 这 
些 事情 要 做 ， 所 以 不 必 对 中 断 流程 做 特殊 处 理 ， 基 本 和 前 后 台 系 统 的 中 断 流程 一 致 。 








1.5 Trochili RTOS 介 绍 


Trochili RTOS 是 一 个 全 新 的 适用 于 嵌入 式 领域 的 实时 操作 系统 ， 主 要 用 C 语 言 开 发 ， 支 持 多 任务 、 多 优先 级 、 抢 占 式 调度 。 英 文 名 称 TROCHILI 取 善 鸣 的 小 鸟 之 意 , 


特点 如 下 : 





“ 支持 抢占 式 调度 多 任务 模型 。 


“ 最 多 支持 32 个 任务 优先 级 ， 多 个 任务 可 以 拥有 同 优先 级 。 


“ 不 同 优先 级 任务 采用 优先 级 调度 ， 相 同 优先 级 任务 间 采 用 时 间 片 调度 。 


:支持 用 户 回调 定时 器 和 任务 定时 器 。 操 作 系 统 内 置 用 户 定时 器 守护 线程 。 


“ 支持 常见 IPC 机 制 ， 如 semaphore、mailbox、 message、 mutex、flago 





“ 充分 总 结 各 种 机 制 的 共性 和 特性 ， 基 于 通用 IPC 控 制 结构 和 操作 流程 ， 做 了 完整 简洁 的 实现 。 


“ 可 配置 的 IPC 调 度 机 制 ， 支 持 FIFO 和 优先 级 两 种 方式 的 线程 阻塞 队列 。 紧 急 消息 操作 优先 普通 消息 操作 。 


* 大 量 API 支 持 在 ISR 中 调用 。 


“ 代码 实现 简洁 ， 注 释 完备 ， 有 十 分 详尽 的 中 文 注释 。 





意味 着 体积 小 巧 、 动 作 灵 敏 。 其 主要 





Trochili RTOS 基 本 实现 了 上 面 介绍 的 RTOS 的 知识 点 ， 并 且 有 自己 的 独特 实现 。 目 前 还 不 能 说 它 是 一 套 成 熟 稳定 的 商业 代码 ， 但 作为 学 习 和 理解 RTOS 确 实 是 不 可 多 得 的 好 资料 。 从 代码 、 注 释 和 文档 上 





看 ， 都 提供 了 大 量 的 图 表 和 大 段 的 中 文 注释 ， 这 些 是 在 别 的 RTOS 代 码 中 看 不 到 。 




















Trochili RTOS 主 要 实现 了 以 下 几 个 功能 : 


“ 线程 管理 和 调度 


~ 


和 互 斥 


地 


By 


: 邮箱 和 消息 队列 


.事件 集合 


“ 定时 器 和 其 守护 线程 


" RTOS 移 植 和 启动 


“ 调试 选项 


作者 将 按照 原理 、 设 计 、 实 现 和 应 用 的 思路 在 随后 的 章节 中 逐步 介绍 Trochili RTOS 的 各 个 功能 模块 。 从 多 个 角度 向 读者 充分 展示 RTOS 的 核心 和 细节 。 
能 实现 自己 的 想法 和 改进 方案 。 相 信和 下面 各 章 的 内 容 一 定 不 会 让 你 失望 。 另 外 因为 现在 Trochili RTOS 只 是 实现 了 内 核 部 分 ， 所 以 下 面 























的 词 ， 请 读者 不 要 疑惑 。 


章节 常 使 用 类 似 “Trochili RTOS”、 


时 人 


“Trochili 内 核 ”、 


希望 读者 不 仅 能 从 中 理解 RTOS 的 概念 和 使 用 ， 还 


“内 核 ” 这 样 


在 第 1 章 中 我 们 已 经 介绍 了 单 核 处 理 器 上 的 多 任务 机 制 的 基本 知识 。 本 章 则 主要 介 绢 
式 仔细 讲解 Trochili RTOS 的 多 任务 机 制 的 实现 。 本 章 按照 原理 、 


2.1 ”线程 结构 设计 


个 系统 内 则 有 多 个 


Trochili RTOS 目 前 的 版 本 没有 明确 提供 进 

















“ 线程 是 任务 代码 在 处 理 器 上 执行 的 过 程 


它 是 操作 系统 调度 的 基本 单位 ， 也 


“ 线程 对 象 由 线程 结构 、 线 程 栈 、 线 程 函数 和 相关 的 线程 数据 等 部 分 组 成 


“ 线程 具有 多 种 运行 状态 


“ 线程 的 状态 及 其 所 处 的 线程 队列 是 匹配 的 


2.1.1 ”线程 的 结构 设计 





据 


Trochili RTOS 是 通过 线程 结构 管理 线程 的 ， 每 个 线程 都 存在 一 个 线程 结构 。 线 程 
结构 ， 线 程 结构 决定 了 操作 系统 的 很 多 特点 。Trochili RTOS 当 前 版 本 的 线程 结构 定义 如 下 。 


代码 清单 2-1: 线程 结构 定义 


资源 分 配 的 基本 单位 


第 2 章 ”线程 管理 与 调度 


程 机 制 ， 而 是 以 线程 来 代表 用 户 任务 ， 线 程 同时 作为 资源 分 配 和 任务 调度 的 基本 证 
线程 。 我 们 可 以 把 Trochili RTOS 定 义 为 基于 轻 量 级 多 线程 的 多 任务 系统 。Trochili RTOS 的 线程 模型 可 以 简要 归纳 为 : 


BRTOS 的 多 任务 机 制 的 设计 和 具体 实现 。 首 先 介绍 Trochili RTOS 的 多 任务 机 制 设计 ， 
设计 、 实 现 的 思路 ， 带 领 读者 逐步 深入 了 解 和 党 


握 RTOS 的 多 任务 机 制 。 


然后 通过 流程 





、 代 码 演 示 的 方 











位。 从 整体 上 考虑 ， 可 以 把 操作 系统 和 用 户 任务 看 作 是 一 个 大 的 进程 ， 而 整 

















结构 定义 在 文件 include\kernel\thread.h 中 ， 其 中 包括 操作 系统 用 来 管理 线程 的 全 部 信息 。 





作为 操作 系统 的 一 种 核心 数 





不 会 更 新 本 成 员 ， 只 有 在 线程 切换 时 才 会 更 新 本 成 员 。 


Ls 
操作 系统 线程 结构 定义 ， 用 于 保存 线程 的 基本 信息 
2. typedef struct ThreadDef 


3,. {1 

4 TThreadID Threagin 

的 
TStackAgddr Se 

St 指针 */ 
TSstackAddr StackTop; 

Si 堆栈 栈 顶 指针 
a oe tus Status; 

Ee A 
a Priority; 

i 当前 优先 级 A 
TPriority BasePriority; 

2 基本 优先 级 wy 


TTimerTick Ticks; 


对 | 间 片 Tes 
数目 


11、 ee BaseTicks; 

时 间 片 长 度 (ticks 

数目 ) */ 

1 TTimerTick TotalTicks; 

时 间 片 长 度 (ticks 

数目 ) 3 

3 TThreadEntry Entry; 

线程 主 程序 地 址 Ef 
14. void* EntryArg; 

多 和 二 和 程序 RA 








eadQueue* Queue; 
A 


TThr 
吉 所 属 线程 队列 指针 


1 #if (TCL IPC ENABLE) 

18.  _ TIpcRecord IpcRecord; 
线程 互 斥 、 同 步 、 通 信 的 控制 结构 6 
19. #endif 

20 


21. #if (TCL TIMER ENABLE) 

说 TTimer Timer; 

线程 自 带 定时 器 

23. #endif 

24. 

2 #if (TCL THREAD AUTHORITY ENABLE) 
TAuthority Authority; 

组 和 理 的 授权 使 能 

2 #endif 


TLinkNode LinkNode; 
用 永明 成 和 各 级 和 队列 的 节点 交 玉 
30. } TThread; 


ThreadID 线 程 编 号 : 每 个 线程 在 初始 化 时 都 由 操作 系统 自动 分 配 一 个 ID。 


/* 


A 


本 


“StackBase 线 程 堆 栈 栈 底 指针 : 在 初始 化 线程 的 时 候 需 要 用 户 提供 一 个 数组 作为 线程 的 栈 ， 数 组 的 地 址 + 数组 长 度 的 值 会 被 作为 线程 栈 起 始 地 址 〈 栈 向 下 增长 的 情况 ) 。 


“ StackTop 线 程 堆栈 栈 顶 指针 : 在 线程 初始 化 的 时 候 被 设置 ， 根 据 处 理 器 对 线程 栈 的 要 求 有 所 不 同 。 注 意 ， 当 线程 执行 时 ， 虽 然 线 程 的 栈 顶 随 函 数 调用 而 变化 ， 但 改变 的 只 是 处 理 器 的 相关 寄存 器 ， 而 


“Status 线 程 状态 : 线程 状态 在 下 文 将 专门 介绍 。 


“ Priority 线 程 当前 优先 级 : 因为 操作 系统 需要 支持 互 斥 量 的 优先 级 继承 策略 ， 所 以 线程 运行 时 的 优先 级 和 线程 的 基本 优先 级 是 分 别 保存 的 。 本 成 员 保存 的 是 线程 运行 时 的 优先 级 。 


时 ， 它 的 数值 和 线程 基本 优先 级 是 相同 的 。 


在 没有 互 斥 量 的 影响 


“ BasePriority 线 程 基 本 优先 级 : 操作 系统 支持 线程 动态 优先 级 ， 这 里 保存 的 是 线程 实际 的 优先 级 ， 可 以 被 相关 线程 管理 函数 修改 。 


“Ticks 时 间 片 中 剩余 时 钟 节拍 数 : 操作 系统 支持 线程 时 间 片 机 制 ， 不 同 线程 可 以 拥有 不 同 长 度 的 时 间 片 。 时 间 片 长 度 以 系统 时 间 节 拍 为 基数 。 本 成 员 保存 的 是 线程 当前 时 间 片 所 剩余 的 数目 ,一旦 减少 
到 0 就 要 考虑 时 间 片 调度 了 。 


“ BaseTicks 时 间 片 长 度 : 线程 时 间 片 的 长 度 ， 当 发 生 时 间 片 调度 时 ， 用 来 恢复 线程 当前 时 间 片 计数 。 操 作 系统 支持 对 时 间 片 长 度 的 修改 ， 用 户 可 以 通过 API 来 改变 线程 时 间 片 的 长 度 。 当 修改 当前 线程 的 
时 间 片 长 度 时 ， 不 必 等 待 下 次 调度 ， 可 以 立刻 生效 。 


:Entry 线程 函数 入 口 : 在 当前 操作 系统 中 ， 线 程 函 数 的 主体 必须 是 一 个 无 限 循环 的 函数 。 
“ EntryArg 线 程 函 数 参数 : 作为 一 个 指针 ， 可 以 指向 任何 类 型 的 数据 。 
:Queue 线 程 所 属 线程 队列 指针 : 内 核 中 有 多 种 类 型 的 线程 队列 ， 下 面 章节 会 详细 介绍 。 非 阻塞 状态 的 线程 所 属 的 队列 由 本 成 员 保存 。 


“ IpcRecord 线 程 互 斥 、 同 步 、 通 信 的 控制 结构 : 线程 因 IPC 而 阻塞 时 ， 需 要 记录 下 很 多 信息 ， 包 括 阻塞 在 哪个 IPC 对 象 上 ， 需 要 传递 的 数据 地 址 等 。 这 些 阻塞 信息 都 存储 在 这 个 成 员 里 。 (有 些 内 核 会 把 
这 个 结构 放 在 线程 /进程 栈 中 ) 。 


“ Timer 线 程 自 带 定时 器 : 用 来 实现 线程 延 时 和 在 IPC 对 象 上 的 时 限 阻 塞 机制 。 
Authority 线程 操作 的 授权 使 能 : 每 个 线程 都 可 以 对 各 种 线程 管理 功能 做 出 不 同 的 配置 。 假 如 某 线程 不 希望 被 挂 起 ， 那 么 在 对 本 成 员 做 出 相应 的 配置 后 ， 所 有 对 它 的 挂 起 操作 都 不 会 成 功 。 
“ LinkNode 线 程 队列 节点 : 用 来 保存 线程 所 属 队列 的 实际 节点 结构 ， 通 过 本 成 员 可 以 把 线程 组 织 成 各 种 链表 结构 。 


' TotalTicks 内 核 运行 时 间 计 数 : 保存 线程 实际 运行 的 时 间 长 度 ， 当 每 次 时 间 片 中 断 时 ， 更 新 一 次 当前 线程 的 运行 时 间 计 数 。 


图 2-1 演 示 了 一 个 线程 结构 及 其 基本 存储 空间 的 分 布 。 








图 2-1 ”线程 结构 演示 


2.1.2 ”线程 的 状态 


在 实际 运行 时 ， 线 程 可 能 会 处 于 不 同 的 状态 。Trochili RTOS 中 的 线程 主要 包括 5 种 状态 。 


代码 清单 2-2: 线程 状态 定义 





让 











Pd 
线程 状态 定义 */ 
2 
. typedef enum 
3 
-1{ 
4 
eThreadDormant = 0, 
休眠 态 */ 
5 
eThreadReady, i 
就 绪 态 */ 
6 
eThreadBlocked, Ed 
态 */ 
7 
& eThreadDelayed, 全 
延 时 态 */ 
8 
eThreadSuspended, 
wy 





挂 起 态 
9 


. } TThreadstatus; 





这 些 状态 的 解释 如 下 。 


“休眠 态 : 
“ 就 绪 态 : 
“ 阻塞 态 : 
“ 延 时 态 : 
. 挂 起 态 : 


线程 在 执行 过 程 中 ， 状 态 是 经 常 变 化 的 。 线 程 的 状态 迁移 如 图 2-2 所 示 。 


处 于 此 状态 的 线程 不 再 参与 线程 调度 。 线 程 初 始 化 后 即 处 于 此 状态 。 

代表 线程 正在 参与 内 核 调 度 ， 随 时 可 能 被 内 核 加 载 到 处 理 器 中 运行 。 当 前 内 核 并 没有 单独 设置 一 个 运行 态 来 代表 正在 处 理 器 上 运行 的 线程 ， 而 是 以 一 个 内 核 全 局 变量 “当前 线程 ”来 代替 。 
说 明 线 程 因为 某 些 条 件 不 允许 而 无 法 完成 一 些 具体 操作 ， 只 好 暂停 运行 ， 等 待 条 件 满足 后 继续 运行 。 

线程 因为 在 时 间 方 面 的 要 求 ， 暂 停 运行 ， 延 时 一 段 时 间 继续 运行 。 


处 于 此 状态 的 线程 不 再 参与 线程 调度 ， 直 到 解除 挂 起 为 止 。 














阻塞 
Blocked 


国共 如 4 阻塞 操作 5 解除 阻塞 


1 线 注 初 台 化 2 线程 激活 -二 一 10 线程 休眠 ~ 8 解 挂 操作 


休眠 11 线程 休 卢 人” 就绪 q 挂 起 
D t Read S dad 
orman 12 误 程 休 眼 会 eady uspen 
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3 线程 休眠 9 线程 挂 起 
6 线程 延 时 
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7 取消 延 时 


uN/ 


Delayed 





图 2-2 ”线程 状态 迁移 图 











线程 的 状态 迁移 和 它 的 行为 或 对 它 的 操作 是 相关 的 。 对 图 2-2 的 分 析 如 下 : 


(1) 线程 初始 化 操作 





线程 被 初始 化 后 就 处 于 休眠 状态 ， 置 于 内 核 线程 辅助 队列 中 。 此 时 它 并 不 参与 线程 调度 ， 只 是 安静 地 待 在 队列 中 等 待 内 核 激活 。 


(2) 线程 激活 操作 


通过 线程 激活 操作 将 线程 转 为 就 绪 状 态 ， 并 置 于 内 核 线程 就 绪 队 列 中 ， 等 待 内 核 调度 。 在 内 核 中 菜 一 时 刻 可 能 多 个 线程 处 于 就 绪 状 态 ， 但 是 只 有 一 个 线程 在 运行 ， 称 为 当前 线程 。 当 前 线程 保持 在 内 核 


线程 就 绪 队 列 中 。 


(3) 线程 休眠 操作 


通过 线程 休眠 操作 可 以 将 处 于 任何 状态 的 线程 (包括 当前 线程 ) 返回 到 休眠 状态 。 这 意味 着 被 休眠 的 线程 不 再 参与 线程 调度 ， 直 到 再 次 激活 。 


(4) 线程 阻塞 操作 


如 果 线程 尝试 访问 某 些 资源 但 是 由 于 某 些 原因 而 没 能 成 功 ， 根 据 访 问 规则 ， 如 果 是 非 阻塞 的 访问 方式 ， 那 么 线程 返回 失败 结果 后 继续 运行 ; 如 果 是 阻塞 的 访问 方式 ， 那 么 线程 就 会 被 内 核 阻塞 在 该 资源 
的 线程 阻塞 队列 上 (每 个 拥有 线程 阻塞 特性 的 资源 都 存在 相关 的 线程 阻塞 队列 ， 用 来 保存 那些 希望 得 到 资源 但 又 不 能 得 到 资源 的 线程 ) 。 随 后 ， 内 核发 起 线程 调度 ， 使 得 当前 线程 放弃 处 理 器 ， 内 核 会 加 载 


其 他 线程 来 运行 。 


(5) 线程 阻塞 解除 操作 


在 线程 释放 资 
(因为 有 新 的 线程 可 以 运行 ， 所 以 此 时 内 核 尝试 发 起 线程 调度 。 但 是 这 样 也 只 


源 时 ， 假 如 该 资源 的 线程 阻塞 队列 上 有 线程 被 阻塞 ， 那 么 当前 线程 会 通过 内 核 从 这 些 被 阻塞 的 线程 中 唤醒 一 个 线程 ， 并 使 它 得 到 该 资源 ， 随 后 内 核 将 该 线程 加 入 内 核 中 的 线程 就 绪 队 列 。 
是 给 了 新 线程 一 个 参与 竞争 处 理 器 资源 的 机 会 ， 不 保证 新 线程 能 够 立刻 得 到 处 理 器 。) 


(6) 线程 延 时 操作 


线程 调用 延 时 函数 时 ， 线 程 首先 将 被 延 时 的 线程 置 于 延 时 状态 并 加 入 内 核 辅助 线程 队列 ， 然 后 开启 该 线程 的 定时 器 。 因 为 在 等 待定 时 结束 的 这 段 时 间 里 ， 该 线程 不 再 参与 内 核 线程 调度 ， 所 以 如 果 被 延 
时 的 是 当前 线程 则 需要 立刻 进行 一 次 线程 调度 。 


(7) 取消 延 时 操 人 
包括 线程 的 延 时 操作 被 明确 终止 ， 或 者 延 时 时 间 到 达 。 前 者 会 提前 将 线程 从 延 时 状态 中 恢复 ， 继 续 参 与 线程 调度 。 
(8) 线程 挂 起 操 1 


对 处 于 就 绪 或 者 运行 的 线程 进行 挂 起 操作 之 后 ， 就 直接 转 为 挂 起 状态 ， 此 时 被 挂 起 的 线程 会 从 线程 就 绪 队 列 转 到 线程 辅助 队列 。 








(9) 线程 唤醒 操 人 





处 于 挂 起 的 线程 可 以 被 唤醒 ， 线 程 从 线程 辅助 队列 中 转移 到 线程 就 绪 队 列 ， 并 且 状 态 设置 为 就 绪 状 态 ， 等 待 被 处 理 器 再 次 运行 。 


2.1.3 ”线程 优先 级 





线程 的 优先 级 用 来 描述 线程 的 重要 性 ， 它 决定 线程 在 获得 内 核 调 度 机 会 上 的 能 力 。 在 线程 调度 时 ， 优 先 级 高 的 线程 会 优先 得 到 调度 机 会 。Trochili RTOS 采 用 的 是 动态 优先 级 机 制 ， 线 程 的 优先 级 可 以 在 
运行 时 修改 。 线 程 优先 级 的 范围 是 0~31， 数 值 越 小 说 明 优先 级 越 高 。 多 个 线程 可 以 拥有 不 同 的 优先 级 ， 也 可 以 拥有 相同 的 优先 级 。 






































户 可 以 通过 系统 调用 直接 改变 某 个 线程 的 优先 级 ， 也 可 以 通过 其 他 操作 间接 地 修改 革 个 线程 的 优先 级 。 当 通过 API 函 数 来 修改 线程 优先 级 时 ， 需 要 注意 某 些 特殊 的 内 核 线程 可 能 没有 被 赋予 “优先 级 可 


变 ” 的 授权 ， 对 这 样 的 线程 进行 优先 级 的 修改 是 不 会 成 功 的 。 










































































内 核 默 认 的 线程 优先 级 分 配 原则 是 : 优先 级 0~2 和 30~31 共 5 个 优先 级 保留 给 内 核 线程 使 用 ， 其 余 27 个 优先 级 分 配给 用 户 线程 使 用 。 内 核 IDLE 线 程 使 用 最 低 优先 级 31。 如 表 2-1 所 示 。 


表 2-1 ”线程 优先 级 分 配 


线程 优先 级 备注 
0 5 内 核 保 久 


1 内 核定 时 带 守 护 线程 优先 级 内 核 占 用 


- | 内 核 保 闪 











3 ~ 29 用 户 线程 优先 级 可 选 范 有 围 
30 内 核 保 留 
31 内 核 IDLE 线程 优先 级 内 核 占用 


2.1.4 线程 时 间 片 








在 线程 时 间 片 长 度 的 设置 上 ， 不 同 线程 可 以 拥有 不 同 长 度 的 时 间 片 ， 并 且 线程 时 间 片 长 度 也 可 以 通过 相关 的 API 函 数 修改 ， 即 Trochili RTOS 支 持 动态 时 间 片 分 配方 案 。 注 意 某 些 特殊 的 内 核 线程 可 能 ; 
有 被 赋予 “时 间 片 长 度 可 改 ” 的 授权 ， 对 这 样 的 线程 进行 时 间 片 长 度 的 修改 是 不 会 成 功 的 。 




















户 可 以 通过 时 间 片 和 优先 级 对 系统 中 的 线程 做 精细 的 配置 。 原 则 上 ， 那 些 对 响应 时 间 要 求 高 的 线程 需要 配置 为 高 优先 级 ;需要 处 理 大 量 数据 的 线程 应 该 配置 成 长 时 间 片 。 对 这 两 个 参数 的 配置 可 以 组 
合 出 精细 的 系统 行为 。 

















2.1.5 ”线程 栈 管理 














在 Trochili RTOS 线 程 管理 过 程 中 ， 应 该 非常 注意 线程 栈 的 使 用 。Trochili RTOS 没 有 采用 任何 保护 机 制 来 确保 用 户 内 存 的 安全 ， 线 程 和 内 核 处 于 同一 个 地 址 空间 ， 各 个 线程 以 及 内 核 的 数据 和 代码 是 统一 
编 址 的 。 









































内 核 中 的 每 个 线程 都 有 自己 的 栈 空间 。 用 户 线程 栈 是 在 用 户 线程 初始 化 时 指定 的 ， 常 见 的 方式 是 以 全 局 数组 作为 线程 栈 。 栈 必须 声明 为 整数 类 型 ( 字 长 ) ， 并 且 必 须 由 连续 的 内 存 空间 组 成 。 具 体 实现 
方式 请 参考 线程 初始 化 函数 的 实现 。 
































在 系统 运行 时 ， 内 核 代 码 和 用 户 线程 一 样 ， 同 样 需要 一 个 运行 栈 。Trochili RTOS 中 并 没有 为 内 核 代码 特别 设 定 运行 栈 ， 而 是 使 用 当前 用 户 线程 的 运行 栈 。 当 用 户 线程 调用 内 核 函 数 时 ， 被 调用 的 内 核 函 
数 将 使 用 当前 用 户 线程 的 栈 ; 但 是 内 核 中 所 有 中 断 服务 程序 会 共享 一 个 独立 的 中 断 栈 ， 这 个 中 断 栈 与 用 户 线程 使 用 的 运行 栈 没有 任何 联系 。 系 统 运行 时 ， 要 保证 任何 类 型 的 栈 都 不 会 溢出 ， 否 则 内 核 会 发 生 
未 知 的 混乱 。 










































































栈 的 管理 跟 具 体 处理 器 和 编译 器 的 特性 相关 。 线 程 栈 中 保存 的 主要 是 线程 执行 时 的 局 部 变量 和 中 断 相 关 的 数据 ， 包 括 : 





“ 线程 被 中 断 时 处 理 器 自动 保存 的 寄存 器 数据 。 





. 调用 函数 时 ， 主 调 函 数 保存 的 寄存 器 数据 。 


“ 区 数 被 调用 时 ， 被 调 澡 数 内 部 的 局 部 变量 。 


2.1.6 “线程 函数 和 线程 数据 








线程 函数 必须 是 一 个 无 限 循环 体 ， 应 用 功能 代码 在 循环 体内 ， 这 样 保证 线程 代码 不 会 执行 完毕 而 直接 返回 ， 否 则 会 因 内 核 无 法 捕获 线程 退出 消息 ， 从 而 导致 内 核 错误 。 如 果 确 实 需要 退出 ， 则 应 该 通过 
系统 调用 ， 显 式 通知 内 核 该 线程 需要 退出 。 线 程 函数 类 型 如 下 : 






































typedef void (*TThreadEntry) (voidx arg) 7 

















注意 ， 参 数 是 个 线程 函数 的 参数 ， 它 是 一 个 void* 类 型 的 变量 ， 这 样 在 线程 初始 化 的 时 候 可 以 带 入 一 个 任意 参数 给 线程 作为 初始 化 数据 。 


线程 函数 结构 如 代码 清单 2-3 所 示 。 





代码 清单 2-3: 线程 函数 结构 





static void ThreadEntry (voidx pArg) 
{ 
while (1) 


{ 
/* application code, do sth. */ 
} 





























需要 注意 的 是 ， 在 线程 函数 里 不 能 长 时 间 关闭 中 断 。 因 为 多 任务 需要 保证 用 户 任务 能 被 中 断 打 断 ， 这 样 操 作 系统 才能 及 时 响应 中 断 。 























线程 数据 主要 包括 栈 数 据 、 全 局 数据 和 动态 数据 。 栈 中 的 数据 编译 器 会 确保 完整 和 正确 。 但 是 全 局 数据 是 各 个 线程 和 内 核 都 能 访问 的 ， 所 以 对 全 局 数据 的 访问 必须 是 互 斥 的 。 

















2.2 ”线程 队列 设计 














内 核 中 的 线程 结构 不 是 分 散在 内 核 各 处 游离 存在 的 ， 每 个 线程 在 某 个 时 刻 必定 属于 某 个 线程 队列 。 线 程 队列 就 是 内 核 用 于 管理 线程 的 数据 结构 ， 它 基本 上 是 按照 线程 状态 的 不 同 而 设置 的 。 线 程 的 状态 
和 它 所 处 的 线程 队列 是 匹配 的 。 在 当前 版 本 的 内 核 中 ， 主 要 包括 的 3 种 线程 队列 如 表 2-2 所 示 。 











表 2-2 ”线程 队列 


线程 队列 个 数 
线程 就 结 队 列 | 用 于 保存 处 于 就 绪 状 态 的 线程 结构 ， 包 括 当前 线程 ( 隐 合 运行 状态 ) | 1 
线程 辅助 队列 | 用 于 保存 处 于 挂 起 、 休 眼 、 延 时 状态 的 线程 结构 1 
线程 阻塞 队列 |。 用 于 保存 阻塞 在 IPC 对 象 上 的 线程 结构 视 IPC 对 象 个 数 而 定 

















需要 注意 的 是 ， 处 于 运行 状态 的 线程 其 实 属 于 就 绪 队 列 。 前 两 个 线程 队列 属于 第 一 种 线程 队列 结构 ， 这 种 线程 队列 结构 的 特点 是 能 够 实现 固定 时 间 的 调度 算法 。 内 核 中 只 有 一 个 线程 就 绪 队 列 和 一 个 线 
程 辅助 队列 。 




















在 IPC 机 制 中 的 各 种 对 象 类 型 ， 大 多 具有 线程 阻塞 队列 ， 这 种 队列 和 线程 就 绪 队 列 及 辅助 队列 的 结构 是 不 一 样 的 。 并 且 这 种 类 型 的 队列 的 个 数 是 不 确定 的 ， 是 根据 实际 使 用 的 IPC 对 象 的 多 少 决 定 的 。 本 
章 只 涉及 第 一 种 线程 队列 类 型 。 




















基本 线程 队列 结构 定义 在 文件 include\kernel\thread.h 中 ， 具 体内 容 如 代码 清单 2-4 所 示 。 








代码 清单 2-4: 基本 线程 队列 结构 定义 





J 
线程 队列 结构 定义 ， 该 结构 大 小 随 内 核 支持 的 优先 级 范围 而 变化 ， 可 以 实现 固定 时 间 的 线程 调度 算法 */ 
typedef struct ThreadQueueDef 

{ 


TPriorityMask PriorityMask; J 
优先 级 掩 码 */ 

TLinkNode* Handle [THREAD PRIORITY NUM]; 人 
线程 分 队列 */ 


} TThreadQueue; 


1. 线程 队列 结构 分 析 
“ PriorityMask 优 先 级 就 绪 标 记 : 每 个 bit 代 表 了 相应 优先 级 的 线程 队列 的 情况 。 如 果菜 个 优先 级 的 分 队列 中 存在 线程 ， 则 这 个 成 员 相 应 的 bit 位 会 被 置 位 。 


“ Handle[ 线 程 优先 级 分 队列 : 该 数组 中 的 每 个 元 素 代表 了 一 个 优先 级 分 队列 的 指针 。 相 同 优先 级 的 线程 处 在 同一 个 优先 级 分 队列 中 。 





线程 队列 结构 如 图 2-3 所 示 。 











TThreadQueue 类 型 定义 


PriorityMask 


Handlel0| 
Handlel 1 


a 
Handlel[n| 


Handle|31| 




















成 员 PriorityMask 表 明了 哪些 优先 级 的 线程 处 于 队列 中 。 通 过 快速 的 计算 算法 ， 内 核 可 以 在 固定 时 间 内 找到 线程 队列 中 最 高 的 就 绪 优先 级 ， 然 后 找到 处 于 该 优先 级 队列 的 第 一 个 线程 。 


2. 线程 队列 操作 


和 线程 队列 相关 的 操作 主要 包括 线程 加 入 队列 、 线 程 移出 队列 、 选 择 队列 中 线程 的 最 高 优先 级 和 选择 队列 中 的 最 高 优先 级 线程 。 这 其 中 主要 涉及 链表 的 操作 和 查找 优先 级 算法 。 线 程 队列 内 ， 按 照 优先 
级 的 不 同 有 多 个 双向 循环 链表 。 线 程 出 入 某 个 线程 队列 时 ， 就 是 对 这 些 链表 进行 的 操作 ， 同 时 完成 线程 队列 其 他 数据 的 更 新 。 


“ 线程 加 入 队列 时 ， 根 据 优先 级 查找 和 它 匹配 的 链表 头 ， 将 它 追 加 到 链表 中 ， 最 后 更 新 线程 所 属 优先 级 是 否 有 线程 存在 的 标记 。 


“ 线程 从 队列 离开 时 ， 同 样 根据 优先 级 查找 和 它 匹 配 的 链表 头 ， 将 它 从 链表 中 删除 ， 最 后 更 新 线程 所 属 优先 级 是 否 有 线程 存在 的 标记 。 


3. 线程 队列 图 示 





























某 个 时 刻 内核 中 线程 就 绪 队列 和 线程 辅助 队列 如 图 2-4 和 图 2-5 所 示 。 


UIhreadReadyQueue 
PriorityMask=0 x 8001 





从 图 2-4 可 以 看 出 ， 在 当前 的 系统 中 ， 线 程 |dle、 线 程 1、 线 程 2、 线 程 3 就 绪 。 并 且 进 一 步 可 知 ， 线 程 1 正在 运行 中 。 线 程 就 绪 队 列 的 优先 级 掩 码 为 0x8001， 即 优先 级 0 和 优先 级 31 有 线程 就 绪 。 


uThreadAuxiliaryQueue 
PriorityMask=0 x 4002 Suspended 





图 2-4 ”线程 就 绪 队 列 图 示 














图 2-5 说 明 ， 在 当前 的 系统 中 ， 线 程 5 和 线程 8 被 挂 起 ， 线 程 6 被 延 时 ， 线 程 7 则 处 于 休 卢 状态。 线程 辅助 队列 的 优先 级 掩 码 为 0x4002， 说 明 优先 级 1 和 优先 级 30 的 队列 中 有 线程 存在 。 





图 2-5 ”线程 辅助 队列 图 示 








到 此 为 止 ， 我 们 已 经 介绍 了 Trochili RTOS 的 多 任务 操作 系统 模型 ， 包 括 线程 和 线程 队列 的 各 个 细节 问题 。 下 面 我 们 就 来 看 看 如 何 实现 这 个 多 任务 操作 系统 模型 。 


2.3 ”线程 调度 机 制 设计 


Trochili RTOS 的 线程 调度 机 制 包括 优先 级 抢占 机 制 和 时 间 片 轮转 机 制 。 在 不 同 优先 级 的 线程 之 间 采 用 优先 级 抢占 机 制 ;在 相同 优先 级 线程 之 间 采 用 时 间 片 轮转 机 制 。 这 种 调度 算法 可 以 兼顾 线程 在 优先 
级 上 的 不 同和 相同 优先 级 线程 之 间 在 占有 CPU 机 会 上 的 公平 性 。 支 持 这 种 调度 机 制 的 核心 数据 结构 就 是 前 面 介绍 的 线程 队列 结构 。 





另外 ， 内 核 进行 任务 调度 操作 所 花费 的 时 间 是 常数 (1PC 线 程 队列 不 是 这 样 的 ) ， 与 应 用 程序 中 建立 的 任务 数 无 关 ， 这 归功 于 内 核 队 列 结构 的 定义 和 队列 操作 浮 数 的 实现 。 线 程 的 优先 级 和 时 间 片 是 在 建 
立 的 时 候 分 配 的 ， 并 且 可 以 在 运行 期 间 修 改 。 内 核对 线程 优先 级 和 时 间 片 管理 可 以 做 到 非常 灵活 。 


2.3.1 ”线程 调度 模型 


在 内 核 中 的 某 一 时 刻 ， 可 能 会 有 多 个 线程 同时 处 于 就 绪 状 态 ， 内 核 必须 决定 某 个 时 刻 应 该 执行 哪个 线程 ， 调 度 算法 是 内 核 的 关键 特性 。 在 线程 调度 部 分 ， 需 要 注意 有 几 个 可 能 发 生 线程 调度 的 时 机 和 可 
能 引起 内 核 调 度 的 函数 。 清 楚 内 核 会 在 什么 情况 下 发 生 调 度 是 很 重要 的 ， 这 里 我 们 总 结 一 下 Trochili RTOS 的 调度 时 机 : 





' 当前 线程 直接 放弃 处 理 器 ， 通 过 API 函 数 实现 。 


: 当前 线程 间接 放弃 处 理 器 〈 无 法 获得 资源 、 优 先 级 变化 、 线 程 持 起、 线程 休眠 、 线 程 阻塞 、 线 程 延 时 等 操作 ) 。 


:时钟 节拍 中 断 处 理 过 程 中 ， 当 前 线程 时 间 片 用 尽 ， 被 迫 放弃 处 理 器 。 





:中断 返 回 过 程 中 ， 当 前 线程 被 更 高 就 绪 优 先 级 线程 抢占 。 


在 上 面 的 介绍 中 ， 我 们 把 内 核 调度 分 为 主动 调度 方式 和 被 动 调度 方式 ， 同 时 线程 调度 也 有 直接 和 间接 的 区 别 。 














从 线程 的 状态 、 线 程 所 处 的 线程 队列 、 线 程 优先 级 、 函 数 所 处 执行 环境 来 考虑 Trochili RTOS 中 的 线程 调度 问题 ， 可 以 总 结 为 下 面 几 点 : 





“ 处 于 就 绪 状 态 的 线程 一 定 处 于 线程 就 绪 队 列 。 


“ 处 于 阻塞 状态 的 线程 一 定 处 于 某 个 IPC 对 象 的 线程 阻塞 队列 。 


“ 处 于 其 他 状态 的 线程 一 定 处 于 内 核 线程 辅助 队列 。 


: 当前 线程 不 一 定 处 于 内 核 线程 就 绪 队 列 。 


: 当前 线程 不 一 定 处 于 内 核 线程 就 绪 队 列 中 最 高 优先 级 的 分 队列 。 


“当前 线程 不 一 定 处 于 内 核 线 程 就 绪 队 列 中 最 高 优先 级 的 分 队列 的 队列 头 。 


“ 当前 线程 不 一 定 是 内 核 最 高 就 绪 优先 级 的 线程 。 


“ 当 内 核 关 闭 线程 调度 时 ， 当 前 线程 不 能 离开 内 核 线程 就 绪 队 列 ， 但 可 以 在 就 绪 队 列 不 同 分 队列 中 移动 。 





“ 如 果 有 线程 加 入 内 核 线 程 就 绪 队 列 中 ， 则 可 能 需要 进行 线程 调度 。 

“ 当前 线程 从 内 核 线程 就 绪 队 列 中 离开 则 必须 申请 线程 调度 。 

' 在 时 钟 节拍 ISR 中 ， 需 要 处 理 当前 线程 的 时 间 片 和 队列 头 指 针 的 调整 问题 。 

“ 在 时 钟 节拍 ISR 中 ， 有 时 需要 处 理 当 前 线程 所 在 就 绪 线 程 队列 的 队列 头 指针 问题 。 

“ 只 有 处 于 线程 就 绪 队 列 各 分 队列 头 位 置 的 当前 线程 ， 才 需要 在 时 间 片 ISR 中 进行 时 间 片 调度 。 
:在座 套 的 中 断 ISR 中 ， 不 必 进 行 线程 调度 处 理 。 


在 实现 内 核 管理 函数 时 ， 均 考虑 了 上 面 的 因素 ， 后 续 章 节 中 将 有 更 详细 的 解释 。 








2.3.2 ”线程 调度 算法 











Trochili RTOS 的 线程 就 绪 优先 级 是 放 在 内 核 线程 就 绪 队列 中 的 PriorityMask 成 员 中 的 ， 该 成 员 是 一 个 32 位 的 变量 ， 每 位 代表 了 一 个 就 绪 的 优先 级 ， 低 位 代表 的 优先 级 高 于 高 位 代表 的 优先 级 。 在 Cortex 
M3 处 理 器 上 ， 可 以 采用 两 条 特殊 的 指令 CLZ 和 RBIT 来 快速 查找 处 于 就 绪 态 的 最 高 优先 级 任务 。 




















. RBIT 把 一 个 32 位 数 水 平 旋转 180 度 。 
“ CLZ 计 算 前 导 零 的 个 数 。 


假设 PriorityMask 的 二 进 制 值 为 00000000000000000000000000001100b， 表 示 在 优先 级 2 和 优先 级 3 的 线程 队列 中 存在 就 绪 线程 。 我 们 首先 通过 RBIT 指 令 将 PriorityMask 数 据 变 为 
00110000000000000000000000000000000000b， 然 后 通过 CLZ 计 算出 前 导 零 的 个 数 为 2， 说 明 在 最 高 就 绪 优先 级 的 那个 BIT 前 有 两 个 0， 进 而 得 知 BIT 2 就 是 当前 最 高 就 绪 优先 级 。 


在 Trochili RTOS 的 线程 就 绪 队 列 中 ， 每 个 优先 级 的 线程 分 队列 占用 4 字 节 ，32 个 优先 级 占用 共 128 字 节 (32X4) 。 出 于 对 RAM 空 间 的 考虑 ， 内 核 现在 只 设置 了 32 个 线程 优先 级 ， 如 果 RAM 许 可 ， 其 实 可 
以 扩展 更 多 优先 级 。 














计算 最 高 就 绪 优 先 级 的 算法 不 是 唯一 的 ， 其 他 的 RTOS 在 优先 级 调度 算法 上 可 能 有 更 好 的 实现 ， 读 者 可 以 自己 研究 一 下 。 





2.3.3 ”线程 调度 步骤 


内 核 的 线程 调度 主要 包含 以 下 三 个 步 





“ 处 理 当 前 线程 的 时 间 片 、 状 态 和 线程 所 处 的 线程 队列 


“ 根据 调度 算法 查找 新 的 就 绪 线程 


“ 在 两 个 线程 之 间 进 行 线程 切换 








其 中 线程 切换 是 一 个 续 密 的 过 程 ， 核 心 功能 需要 由 汇编 代码 来 完成 ， 因 为 C/C+ + 等 高 级 语言 是 无 法 处 理 此 时 的 处 理 器 上 下 文 的 。 内 核 首 先 把 当前 线程 的 寄存 器 上 下 文保 存 到 它 的 线程 栈 中 ， 更 新 线程 结 
构 中 的 线程 栈 项 成 员 。 然 后 再 把 需要 切换 运行 的 线程 的 寄存 器 上 下 文 从 它 的 线程 栈 中 加 载 到 处 理 器 寄存 器 组 中 ， 从 而 完成 线程 切换 。 











2.4 ”线程 管理 和 调度 实现 


谋 入 式 操作 系统 的 最 基本 功能 就 是 任务 的 管理 与 调度 。Trochili RTOS 提 供 基 本 的 线程 管理 与 调度 API 函 数 。 























本 章 最 后 的 内 容 主要 分 析 了 与 线程 管理 与 调度 相关 的 各 个 API 函 数 的 功能 与 实现 ， 对 相关 代码 也 进行 了 讲解 ， 但 是 对 于 API 函 数 内 部 调用 的 函数 ， 则 只 是 根据 需要 进行 合理 取舍 后 ， 对 部 分 进行 了 分 析 讲 
解 。 在 内 核 的 源 代码 中 有 非常 详细 的 注解 ， 在 本 章 中 不 再 歼 述 。 

















Trochili RTOS 实 现 了 如 下 线程 管理 和 调度 功能 : 
“ 线程 初始 化 《Init) 

' 线程 激活 和 休眠 (Activate\DeActivate) 

“ 线程 挂 起 和 唤醒 挂 起 (Suspend\Resume) 

“ 线程 主动 调度 (Yield) 

“ 线程 延 时 (Delay) 

“ 线程 优先 级 管理 (SetPriority) 

“ 线程 时 间 片 管理 (SetTimeSlice) 

“ 线程 管理 授权 (Autherity) 

线程 管理 功能 如 表 2-3 所 示 。 


表 2-3 ”线程 管理 功能 


亚 数 备注 











TclInitThread 线程 初始 化 初始 化 线程 结构 和 数据 
TclSuspendThread 线程 挂 起 将 就 绪 态 的 线程 挂 起 
TclResumeThread 线程 解 挂 将 挂 起 态 的 线程 重新 放 回 就 绪 队 列 
TclDelayThread 将 就 绪 态 的 线程 延 时 一 段 时 间 
TclUndelayThread 线程 延 时 取消 提前 将 延 时 的 线程 唤醒 ， 解 除 延 时 
TclActivateThread 线程 — 处 一 休眠 状态 的 线程 激活 
TclDeActivateThread 于 任何 状态 的 线程 置 于 休眠 态 
TclYieldThread 线程 主动 调度 和 中 的 线程 主动 放 处 理 器 


TclSetThreadPriority 修改 线程 优先 级 修改 任何 状态 的 线程 的 优先 级 
TclSetThreadSlice 修改 线程 时 间 片 修改 任何 状态 的 线程 的 时 间 片 长 度 





线程 管理 授权 机 制 


Trochili RTOS 在 设计 的 时 候 ， 在 线程 功能 的 使 用 方面 做 了 特殊 的 处 理 ， 设 计 了 一 个 线程 管理 操作 的 授权 /验证 机 制 。 即 对 线程 进行 管理 时 ， 如 果 被 操作 的 线程 并 没有 使 能 相关 功能 ， 那 么 操作 是 不 会 成 功 
的 。 这 就 给 线程 管理 和 内 核 的 设计 带 来 了 很 大 方便 ， 比 如 内 核 IDIE 线 程 要 一 直 处 于 就 绪 状 态 ， 不 能 被 挂 起 、 阻 塞 或 者 休眠 。 如 果 在 每 个 任务 管理 的 API 中 都 判断 被 操作 的 线程 是 不 是 IDLE 线 程 ， 那 内 核实 现 
时 就 比较 繁琐 和 凌乱 了 ， 特 别 是 在 内 核 内 置 的 线程 较 多 时 。 而 在 Trochili RTOS 中 ， 则 是 通过 检查 IDIE 线 程 的 功能 授权 操作 来 完成 的 。 每 个 线程 都 有 它 的 操作 授权 集合 ， 可 以 简单 灵活 地 配置 组 合 各 种 属性 。 
比如 内 核 IDIE 线 程 只 有 被 激活 的 授权 ， 那 么 其 他 线程 是 无 法 通过 API 来 使 它 休眠 或 者 挂 起 的 。 


2.4.1 线程 初始 化 








线程 初始 化 函数 为 线程 分 配 和 初始 化 相关 的 数据 结构 信息 。 线 程 可 以 在 多 线程 调度 开始 前 初始 化 ， 也 可 以 在 其 他 线程 的 执行 过 程 中 初始 化 。 它 的 主要 操作 有 如 下 几 个 步骤 : 





“ 构造 线程 原始 堆栈 栈 帧 


“ 设置 线程 时 间 片 相关 参数 


“ 设置 线程 优先 级 


: 设置 线程 编号 (ID) 


“ 设置 线程 定时 器 信息 


“ 设置 线程 链表 节点 信息 


“ 清空 线程 间 通 信 信息 


“ 将 线程 加 入 内 核 辅助 线程 队列 


“ 设置 线程 状态 为 休眠 态 














初始 化 后 的 线程 不 会 立刻 执行 ， 而 是 首先 被 置 为 休眠 态 ， 放 在 内 核 线程 辅助 队列 (uThreadAuxiliaryQueue) 中 ， 然 后 在 合适 时 机 被 内 核 或 用 户 激活 。 激 活 后 的 线程 处 于 内 核 线程 就 绪 队列 中 ， 状 态 为 
就 绪 态 。 线 程 初始 化 函数 本 身 没 有 复杂 的 逻辑 ， 它 按照 参数 来 配置 线程 各 结构 成 员 。 值 得 注意 的 是 ， 在 这 个 函数 里 会 伪造 线程 首次 运行 时 的 栈 帧 ， 这 个 操作 的 实现 和 处 理 器 硬件 细节 密切 相关 ， 将 在 第 10 章 
详细 介绍 。 在 这 里 只 需要 知道 ， 线 程 首 次 运行 时 的 栈 帧 是 由 内 核 伪 造 的 就 可 以 了 。 



































2.4.2 ”线程 激活 








Trochili RTOS 实 现 了 线程 激活 的 功能 。 在 前 面 介 绍 过 ， 初 始 化 后 的 线程 都 处 于 休眠 状态 ， 并 不 能 立刻 参与 线程 调度 。 需 要 通过 线程 激活 API 完 成 线程 的 激活 后 ， 线 程 才 会 进入 内 核 就 绪 线程 队列 ， 参 与 
系统 实际 的 调度 和 运行 。 


只 有 处 于 休眠 状态 的 线程 才 可 以 被 线程 和 1SR 激 活 。 对 线程 进行 激活 时 ， 会 将 处 于 休眠 的 线程 从 线程 辅助 队列 uUThreadAuxiliaryQueue 中 移出 ， 随 后 放 入 线程 就 绪 队 列 uUThreadReadyQueue 中 。 并 且 将 
线程 的 状态 转 为 就 绪 态 。 某 个 线程 被 激活 后 ， 如 果 该 线程 的 优先 级 高 于 内 核 当前 最 高 就 绪 优先 级 ， 则 内 核 立刻 发 出 线程 调度 请 求 ， 完 成 线程 的 优先 级 调度 抢占 。 





线程 激活 操作 的 核心 步骤 是 : 

“ 把 线程 从 内 核 辅 助 队列 中 移 到 内 核 就 绪 队 列 
: 设置 线程 状态 为 就 绪 

“ 必要 时 ， 发 起 线程 调度 请 求 

整个 线程 激活 的 过 程 需要 考虑 以 下 几 个 问题 : 
“ 线程 是 否 允 许 进行 激活 操作 

“ 线程 是 否 处 于 休眠 态 

“当前 内 核 是 否 允 许 线程 调度 

“ 函数 被 线程 调用 还 是 被 ISR 调 用 


线程 激活 操作 的 主要 流程 如 图 2-6 所 示 。 


2 内 核 进入 独占 区 





3 线程 可 以 被 激活 ? 





6 被 激活 线程 优先 级 





高 于 当前 线程 ? 





10 内 核 退出 独占 区 


图 2-6 ”线程 激活 流程 图 


线程 激活 流程 图 分 析 : 

STEP3 如 果 某 个 线程 没有 配置 成 可 激活 ， 那 么 对 该 线程 的 激活 操作 会 失败 。 

STEP4 ”激活 操作 只 对 处 于 休眠 状态 的 线程 有 效 。 

STEP5 激活 线程 ， 主 要 是 对 线程 的 队列 和 状态 的 操作 。 

STEP6 如 果 被 激活 的 线程 的 优先 级 高 于 当前 线程 优先 级 则 需要 检查 是 否 需要 线程 调度 。 
STEP7 如 有 果 内 核 没有 关闭 线程 调度 则 需要 考虑 线程 调度 的 问题 。 

STEP8 如 果 线 程 激活 函数 是 被 ISR 调 用 则 不 需要 发 起 线程 调度 。 

STEP9 向 内 核发 出 线程 调度 请 求 。 

STEP10 内核 代 码 退 出 独占 区 。 在 中 断 退 出 时 ， 内 核 可 能 响应 线程 调度 请 求 。 


线程 激活 的 伪 代 码 如 代码 清单 2-5 所 示 。 


代码 清单 2-5: 线程 激活 伪 代码 





主 

线程 激活 
2 

区 

急 
关闭 中 断 

4 

如 果 线程 可 以 被 激活 
5 

. { 

6 
如 果 线程 处 于 休 眼 状态 


- 
8 


将 线程 从 内 核 畏 助 线程 移出 
如 果 被 激活 线程 是 当前 线程 
10 


{ 
11 


线程 在 内 核 就 绪 线程 队列 的 位 置 为 队列 头 
12 


} 
13 


将 线程 放 入 内 核 线程 就绪 队列 


设置 线程 类 态 为 激活 
这 
16 


如 果 被 操作 的 线程 的 优先 级 高 于 线程 就 绪 队 列 的 最 高 优先 级 
17 

并 且 内 核 此 时 并 没有 关闭 线程 调度 ， 

18 


其 且 林 函数 被 线程 调度 
下 














- { 
20 


那么 就 需要 发 出 线程 调度 请 求 
21 

22 
23 








2.4.3 ”线程 休 眼 





Trochili RTOS 实 现 了 线程 休眠 的 功能 ， 可 以 将 处 于 就 绪 状 态 、 延 时 状态 和 阻塞 状态 的 线程 休眠 ， 不 再 参与 内 核 运行 。 如 果 休 有 眠 的 是 当前 线程 则 需要 进行 线程 调度 。 
线程 休眠 操作 的 核心 步骤 如 下 : 

“ 把 处 于 阻塞 状态 的 线程 从 IPC 的 线程 阻塞 队列 中 转移 到 内 核 线程 辅助 队列 

“ 把 处 于 延 时 状态 的 线程 保持 在 内 核 辅助 队列 线程 队列 


“ 把 处 于 挂 起 状态 的 线程 保持 在 内 核 辅助 队列 线程 队列 


N 


: 把 处 于 就 绪 状 态 的 线程 从 内 核 就 绪 线 程 队列 中 转移 到 内 核 线程 辅助 队列 


“ 设置 线程 状态 为 休眠 





“ 必要 时 向 内 核 申请 线程 调度 





整个 线程 休眠 的 过 程 需要 考虑 以 下 几 个 问题 : 


“ 线程 是 否 允 许 被 休眠 。 


“ 线程 处 于 哪个 状态 ? 延 时 、 就 绪 、 挂 起 还 是 阻塞 ? 


"内核 当前 是 否 允 许 线程 调度 。 


“ 函数 被 线程 调用 还 是 被 TSR 调 用 。 





线程 休眠 操作 的 3 





流程 如 图 2-7 所 示 。 

















线程 休眠 流程 图 分 析 : 








STEP3 如 果 某 个 线程 没有 配置 成 可 休眠 ， 那 么 对 该 线程 的 休眠 操作 会 失败 。 


STEP4 ”线程 处 于 阻塞 态 则 调用 相关 吨 数 将 阻塞 态 的 线程 休眠 。 


STEP5 判断 线程 是 否 处 于 就 绪 态 ， 如 果 是 则 处 理 就 绪 态 的 线程 休眠 。 


STEP6 判断 线程 是 否 处 于 挂 起 态 ， 如 果 是 则 处 理 挂 起 态 的 线程 休眠 。 


STEP7 判断 线程 是 否 处 于 延 时 态 ， 如 果 是 则 处 理 延 时 态 的 线程 休眠 。 


STEP11 如 果 该 线程 是 当前 线程 ， 则 需要 检查 内 核 是 否 允 许 调度 〈 这 个 判断 条 件 包 含 了 很 复杂 的 情况 ) 。 


STEP12 ”如果 内 核 不 允许 线程 调度 则 直接 退出 。 


STEP13 如 果 内 核 允许 线程 调度 则 将 线程 休眠 。 


STEP15 如 果 函 数 被 线程 调用 则 向 内 核 申 请 线程 调度 。 


STEP17 内 核 代 码 退 出 独占 区 后 ， 可 能 发 生 线程 切换。 引起 线程 切换 的 原因 有 可 能 是 线程 休眠 操作 ， 也 可 能 是 其 他 原因 。 


线程 休眠 的 伪 代 码 如 代码 清单 2-6 所 示 。 





代码 清单 2-6: 线程 休眠 伪 代码 





二 
线程 休眠 
2. { 


3 

关闭 中 断 ; 
4. 
如 果 该 线程 可 以 被 休眠 
5. { 


判断 线程 状态 : 

了 。 { 

8. 

如 果 线 程 处 于 延 时 状态 ， 将 线程 取消 延 时 ， 但 是 线程 仍然 处 于 辅助 队列 ， 将 线程 设 为 体检 
如 果 线程 处 于 阻塞 状态 :将 该 线程 从 阻塞 队列 中 移出 ， 加 入 线程 辅助 队列 ， 将 线程 设 为 休眠 态 





10。 
如 果 线 程 处 于 就 绪 状态 : 
11. { 


12。 

如 果 是 当前 线程 

二 3。 

14. 

于 内 核 没有 关闭 线程 调度 
15s { 


16. 
将 该 线程 设 为 休 眼 态 ， 并 且 加 入 线程 辅助 队列 
Tks 
如 果 是 线程 环境 则 需要 马上 开始 线程 调度 
} 


Ts } 


21. { 

22. 

将 该 线程 设 为 休眠 态 ， 并 且 加 入 线程 辅助 队列 

23. } 

24. } 

25. 

生生 种 人 了 全 人 将 该 线程 设 为 休眠 态 
} 

27. T 


打开 中 断 
29: 








2.4.4 ”线程 挂 起 
Trochili RTOS 实 现 了 线程 挂 起 的 功能 。 处 于 就 绪 状态 的 线程 可 以 被 线程 和 ISR 挂 起 ， 如 果 是 当前 线程 被 挂 起 则 内 核 立 刻 发 出 线程 调度 请 求 ; 同样 ， 只 有 处 于 挂 起 状态 的 线程 才 可 以 被 线程 和 ISR 解 挂 ， 如 
果 解 挂 后 的 线程 的 优先 级 高 于 当前 线程 的 优先 级 则 内 核 立 刻 发 出 线程 调度 请 求 。 
线程 挂 起 操作 的 核心 步骤 是 : 
“ 把 线程 从 内 核 就 绪 队 列 中 移 到 内 核 辅助 队列 
:设置 线程 状态 为 挂 起 
“ 必要 时 ， 发 出 线程 调度 
整个 线程 挂 起 的 过 程 需要 考虑 以 下 几 个 问题 : 
“ 线程 是 否 允 许 被 挂 起 
“ 线程 是 否 处 于 就 绪 态 
“ 内 核 是 否 允 许 线程 调度 


“ 区 数 被 线程 调用 还 是 被 ISR 调 用 








线程 挂 起 操作 的 主要 流程 如 图 2-8 所 示 。 

















线程 挂 起 流程 图 分 析 : 





STEP3 如 果 某 个 线程 没有 配置 成 可 挂 起 ， 那 么 对 该 线程 的 挂 起 操作 会 失败 。 





STEP4 挂 起 操作 只 对 处 于 就 绪 状态 的 线程 有 效 。 


STEP5 ”如果 被 挂 起 的 线程 是 当前 线程 则 说 明 挂 起 操作 会 引起 线程 调度 。 


STEP6 但 如 果 此 时 内 核 不 允许 线程 调度 则 本 次 挂 起 操作 失败 。 


STEP7 处 于 就 绪 态 的 非 当前 线程 直接 进行 线程 挂 起 操作 。 


STEP8 挂 起 线程 ， 主 要 是 对 线程 队列 和 状态 的 操作 。 





”2 内 核 进入 独占 区 





oj 


417 内 核 退 出 独占 区 






图 2-7 ”线程 休眠 流程 图 


STEP9 检查 函数 是 否 被 线程 调用 。 


STEP10 如 果 是 则 向 内 核 申请 线程 调度 。 


STEP11 ”内核 代 码 退 出 独占 区 后 ， 可 能 发 生 线程 调度 。 








11 内 核 退出 独占 区 





图 2-8 ”线程 挂 起 流程 图 


线程 挂 起 伪 代 码 如 代码 清单 2-7 所 示 。 


代码 清单 2-7: 线程 挂 起 伪 代码 





下 
线程 挂 起 
2. 1{ 


3 
关闭 中 断 ; 


4. 
如 果 线 程 可 以 被 挂 起 
5. { 


6 

各 果 线 各 八 志 0 了 入 侣 
- 

8. 

如 果 是 当前 线程 
9 

10 

如 果 内 核 此 时 没有 禁止 线程 调度 
计 。 { 


2 

挂 起 线程 

13. 

如 染 卫 牧 被 久 程 凋 用 








2.4.5 ”线程 解 挂 





Trochili RTOS 实 现 了 线程 解 挂 的 功能 。 跟 线程 挂 起 相 比较 ， 这 里 不 需要 考虑 内 核 是 否 人 允许 线程 调度 ， 这 是 因为 当前 线程 的 挂 起 必然 导致 线程 调度 。 而 在 线程 解 挂 的 流程 ， 并 不 一 定 进行 线程 切换 ， 不 需 
要 关心 内 核 是 否 人 允许 线程 调度 。 在 线程 挂 起 的 流程 中 ， 很 早 就 对 内 核 调度 是 否 使 能 进行 判断 ， 而 解 挂 时 ， 则 推迟 到 最 后 尝试 线程 调度 阶段 才 处 理 。 


线程 解 挂 操作 的 核心 步骤 是 : 

“ 把 线程 从 内 核 辅助 队列 中 移 到 内 核 就 绪 队 列 
“ 设置 线程 状态 为 就 绪 

“ 必要 时 ， 向 内 核 申 请 线程 调度 

整个 线程 解 挂 的 过 程 需 要 考虑 以 下 几 个 问题 : 
“ 线程 是 否 允 许 被 解 挂 

“ 线程 是 否 处 于 挂 起 状态 


:函数 被 线程 调用 还 是 被 TSR 调 用 





线程 解 挂 操作 的 主要 流程 如 图 2-9 所 示 。 


2 内 核 进 入 独占 区 


3 线程 可 以 被 解 挂 ? 


吾 | 













AE 


内 核 允 许 线程 调度 ? 


征 
» 
口 条 


否 8 国 数 被 线程 调用 ? 















线程 解 挂 流程 图 分 析 : 








STEP3 如 果菜 个 线程 没有 配置 成 可 解 挂 ， 那么 对 该 线程 的 解 挂 操作 会 失败 。 
STEP4 和 解 挂 操作 只 对 处 于 挂 起 状态 的 线程 有 效 。 


STEP5 解 挂 线程 ， 主 要 是 对 线程 队列 和 状态 的 操作 。 


STEP6 ”如 果 被 解 挂 的 线程 的 优先 级 高 于 当前 线程 的 优先 级 则 需要 检查 是 否 需要 调度 。 


STEP7 如 果 内 核 没 有 关闭 线程 调度 则 需要 考虑 线程 调度 的 问题 。 

STEP8 如 果 线 程 解 挂 函 数 是 被 ISR 调 用 则 不 需要 发 出 线程 调度 。 

STEP9 向 内 核发 出 线程 调度 请 求 。 

STEP10 内 核 代 码 退 出 独占 区 ， 在 中 断 退 出 时 ， 内 核 可 能 响应 线程 调度 请 求 。 


线程 解 挂 的 伪 代 码 如 代码 清单 2-8 所 示 。 


代码 清单 2-8: 线程 解 挂 伪 代 码 


10 内 核 退 出 独占 区 


图 2-9 ”线程 解 挂 流程 图 





站 
人 村 


nh 
i 


全 凡人 为 所 





有 

线程 离开 内 核 辅助 线程 队列 
gw 

如 果 是 当前 线程 

10s 


11s 
a 


各 加入 内 全线 和 
可 为 


如 家 人 的 上 的 人 和 人 亩 于 线程 细 愉 列 的 最 雷公 





并 用 没 有 交加 线程 
Nm 

那么 就 需要 申请 线程 调度 

21. } 

22。 } 

23。 } 

24. 

打开 中 断 

25. } 





2.4.6 ”线程 正 时 


























在 线程 运行 的 过 程 中 ， 有 可 能 需要 延 时 一 段 时 间 ， 这 时 需要 使 用 线程 延 时 函数 ， 它 启动 当前 线程 的 软 定时 器 ， 将 其 加 入 内 核定 时 器 队列 ， 随 后 把 线程 加 入 内 核 线程 辅助 队列 ， 直 到 定时 器 到 时 ， 内 核 自 
动 唤醒 该 线程 ， 该 线程 继续 运行 。 

















需要 注意 的 是 ， 每 个 线程 都 拥有 一 个 软 定时 器 ， 线 程 延 时 和 资源 时 限 等 待 功能 都 是 通过 这 个 软 定时 器 实现 的 。 另 外 ， 因 为 软 定时 器 是 通过 系统 时 钟 节拍 中 断 实现 的 ， 所 以 它 的 精度 是 有 限定 的 ， 在 10ms 
的 时 钟 节拍 下 ， 软 定时 器 的 精度 是 上 下 10ms。 














Trochili RTOS 实 现 了 线程 延 时 的 功能 。 只 有 处 于 就 绪 状态 的 线程 可 以 被 线程 和 ISR 延 时 ， 如 果 当 前 线程 被 延 时 ， 内 核 会 立刻 发 出 线程 调度 请 求 ; 同样 ， 只 有 处 于 延 时 状态 的 线程 才 可 以 被 线程 和 ISR 取 消 
延 时 ， 如 果 延 时 取消 后 的 线程 的 优先 级 高 于 当前 线程 的 优先 级 则 内 核 尝试 发 起 线程 调度 请 求 。 











线程 延 时 操作 的 核心 步骤 是 : 

: 把 线程 从 内 核 就 绪 队 列 中 移 到 内 核 辅助 队列 
“ 设置 线程 状态 为 延 时 

“ 启动 线程 定时 器 

“ 必要 时 向 内 核发 出 线程 调度 请 求 


整个 线程 延 时 的 过 程 需要 考虑 下 面 几 个 问题 : 





“ 线程 是 否 允 许 被 延 时 


“ 线程 是 否 处 于 就 绪 态 ， 是 否 是 当前 线程 被 延 时 


“内核 是 否 允 许 线程 调度 


:函数 被 线程 调用 还 是 被 TSR 调 用 








线程 延 时 操作 的 主要 流程 如 图 2-10 所 示 。 














下 
9 函数 被 线程 调用 ? 
是 


y 
| 


11 内 核 退出 独占 区 


图 2-10 ”线程 延 时 流程 图 
线程 延 时 流程 图 分 析 : 


STEP3 如 果菜 个 线程 没有 配置 成 可 延 时 ， 那 么 对 该 线程 的 延 时 操作 会 失败 。 


STEP4 延 时 操作 只 对 处 于 就 绪 状 态 的 线程 有 效 。 


STEP5 如 果 被 延 时 的 线程 是 当前 线程 则 说 明 延 时 操作 会 引起 线程 调度 。 


STEP6 但 如 果 此 时 内 核 不 允许 线程 调度 则 本 次 延 时 操作 失败 。 


STEP7 “当前 线程 延 时 ， 主 要 是 对 线程 队列 和 状态 的 操作 ; 同时 启动 线程 定时 器 。 


STEP9 判断 函数 是 不 是 被 线程 调度 。 


STEP10 如 果 是 则 向 内 核发 出 线程 调度 请 求 。 


STEP11 内 核 代码 退出 独占 区 后 ， 可 能 发 生 线程 调度 。 


线程 延 时 的 功能 是 和 线程 定时 器 紧密 相关 的 ， 在 第 8 章 中 会 重点 介绍 。 线 程 延 时 的 伪 代 码 如 代码 清单 2-9 所 示 。 


代码 清单 2-9: 线程 延 时 伪 代 码 








ls 
线程 延 时 
2. { 


3 
关闭 中 断 ; 


4. 
如 果 线 程 可 以 被 延 时 
5. { 


6. 

如果 线程 状态 为 驶 结 态 
- 

8. 

如 果 是 当前 线程 

和 { 

10. 

如 果 内 核 此 时 没有 禁止 线程 调度 

i { 


12。 

和 。 和 让 出 

3 

加 条 作 本 雪人 个 编程 轴 用 


15 
需要 申请 线程 调度 
十 6。 


21 . 
将 线程 延 时 
22; 


23; } 
24. } 


打开 中 断 
流入 永 








2.4.7 ”线程 延 时 取消 


这 个 功能 和 线程 延 时 正好 相 








反 ， 要 把 已 经 休眠 的 线程 时 


线程 延 时 取消 操作 的 核心 步骤 是 : 


“ 把 线程 从 内 核 辅助 队列 中 


“ 设置 线程 状态 为 就 绪 


“ 停止 线程 定时 器 


“ 必要 时 向 内 核 申请 线程 调 


移 到 内 核 就 绪 队 列 


度 


整个 线程 延 时 取消 的 过 程 需要 考虑 下 面 几 个 问题 : 


' 线程 是 否 允 许 被 取消 休眠 


“ 线程 是 否 处 于 休眠 状态 





“ 区 数 被 线程 调用 还 是 被 ISR 调 用 


新 调整 为 就 绪 态 ， 取 消 先 前 的 休眠 操作 。 


跟 线 程 延 时 相 比较 ， 这 里 不 需要 考虑 内 核 是 否 人 允许 线程 调度 ， 这 是 因为 当前 线程 的 延 时 必然 导致 线程 调度 ， 而 在 线程 延 时 取消 的 流程 ， 并 不 一 定 进行 线程 切换 ， 不 需要 关心 内 核 是 否 人 允许 线 程 调度 。 在 
线程 延 时 的 流程 中 ， 很 早 就 对 内 核 调度 是 否 使 能 进行 判断 ， 而 延 时 取消 时 ， 则 推迟 到 最 后 尝试 线程 调度 阶段 才 处 理 。 





线程 延 时 取消 操作 的 主要 流程 如 图 2-11 所 示 。 

















2 内 核 进 入 独占 区 





在 





一 3 线程 可 以 被 取消 延 时 ? 


6 该 线程 优先 级 高 
于 当前 线程 ? 





线程 延 时 取消 流程 图 分 析 : 











11 过 加 








图 2-11 ”线程 延 时 取消 流程 图 








STEP3 如 果 某 个 线程 没有 配置 成 延 时 可 取消 ， 那 么 对 该 线程 的 操作 会 失败 。 


STEP4 取消 延 时 只 对 处 于 延 时 状态 的 线程 有 效 。 


STEP5 ”取消 线程 延 时 ， 主 要 是 对 线程 队列 和 状态 的 操作 ; 同时 关闭 线程 定时 器 。 


STEP6 如 果 被 取消 延 时 的 线程 的 优先 级 高 于 当前 线程 的 优先 级 则 需要 检查 是 否 需要 调度 。 


STEP7 如 果 内 核 没有 关闭 线程 调度 ， 则 需要 考虑 线程 调度 的 问题 。 


STEP8 如 果 线 程 延 时 取消 函数 是 被 ITSR 调 用 ， 则 不 需要 发 出 线程 调度 。 


STEP9 向 内 核发 出 线程 调度 请 求 。 


STEP10 内 核 代码 退出 独占 区 ， 在 中 断 退 出 时 ， 内 核 可 能 响应 线程 调度 请 求 。 


线程 延 时 取消 的 伪 代 码 如 代码 清单 2-10 所 示 。 


代码 清单 2-10: 线程 延 时 取消 伪 代 码 





1 
线程 延 时 取消 
2. { 


3 

关闭 中 断 ; 

4. 

如 果 线 程 可 以 被 取消 延 时 
5. { 


6. 
En 
{ 





8. 

线程 离开 内 核 畏 有 线程 队列 

如 果 是 当前 线程 

10. 

Tl, 

线程 将 被 放 入 内 核 就 绪 线 程 队列 的 队列 头 
12; } 

十 3。 

将 线程 加 入 内 核 就 绪 线程 队列 

14。 

设 宣 线程 状态 为 就 绪 

15, 

16: 

如 泉 被 操作 的 线程 的 优先 级 高 于 线程 绪 队 列 的 最 高 优先 级 ， 


养生 内 核 此 时 并 没有 关闭 线程 调度 ， 
并 且 本 函数 被 线程 调度 
19 { 














20. 
需要 申请 线程 调度 
21. } 





2.4.8 ”线程 主动 调度 


Trochili RTOS 实 现 了 用 户 级 线程 主动 调度 功能 ， 即 当前 线程 通过 该 API 尝 试 将 处 理 器 控制 权 释放 ， 转 让 给 别 的 线程 。 当 前 线程 只 能 把 处 理 器 让 给 同 优先 级 的 线程 。 























DLE 守 护 线程 是 Trochili RTOS 中 具有 最 低 优先 级 的 就 绪 线 程 ， 因 




















级 线程 主动 调度 的 核心 步骤 是 : 
“ 查找 新 的 就 绪 线程 用 于 调度 


“ 向 内 核发 出 线程 调度 请 求 











户 级 线程 主动 调度 的 过 程 需要 考虑 下 面 几 个 问题 : 














“ 当前 线程 是 否 允 许 主动 发 起 调度 


各 


核 当前 是 否 允 许 线程 调度 


“ 只 能 被 当前 线程 调用 执行 


线程 主动 调度 的 操作 的 主要 流程 如 图 2-12 所 示 。 














为 它 一 直 处 于 就 绪 状 态 ， 所 以 某 个 就 绪 线 程 如 果 调 用 TclYieldThread () 函数 ， 不 会 导致 内 核 中 没有 就 绪 线 程 的 错误 。 














图 2-12 ”线程 主动 调度 流程 图 


线程 主动 调度 流程 图 分 析 : 

STEP3 如 果 当 前 线程 不 支持 主动 放弃 处 理 器 ， 那 么 操作 会 失败 。 

STEP4 如 果 兄 数 不 是 被 线程 调用 或 者 内 核 不 允许 线程 调度 则 退出 。 

STEP5 判断 是 否 有 相同 优先 级 的 就 绪 线 程 。 

STEP6 如 果 有 相同 优先 级 的 就 绪 线 程 ， 则 将 当前 线程 所 处 队列 的 头 指 针 下 移 。 
STEP7 得 到 新 的 就 绪 线程 等 待 调度 。 

STEP8 向 内 核发 出 线程 调度 请 求 。 

STEP9 内核 代码 退出 独占 区 后 ， 可 能 发 生 中 断 ， 发 生 线 程 调度 。 


用 户 级 线程 主动 调度 的 伪 代 码 如 代码 清单 2-11 所 示 。 


代码 清单 2-11: 用 户 级 线程 主动 调度 伪 代 码 





js 
有 条 全 种 辣 度 


二 

关闭 中 

如 果 当 前 线程 可 以 调用 本 函数 
是 


6. 
如 果 是 线程 调用 本 了 
基 且 内 核 从 放 线程 调度 


9. 
如 果 有 和 当前 线程 优先 级 相同 的 线程 存在 
10; E 


i 

当前 线程 所 处 内 术 就 结 线 程 队 列 分 队列 的 头 指 针 下 移 
重新 得 出 最 佳 就 绪 线程 

he 油 

向 内 核 申请 线程 调度 

14. : 


15: } 
1 } 


打开 中 断 ; 
T1868 











2.4.9 ”线程 优先 级 设 定 

Trochili RTOS 中 ， 实 现 了 线程 动态 优先 级 的 功能 。 用 户 线程 可 以 在 运行 过 程 中 主动 地 修改 自己 或 者 其 他 线程 的 优先 级 。 因 为 内 核 是 根据 线程 的 优先 级 来 安排 线程 所 处 队列 的 ， 所 以 修改 线程 优先 级 的 过 
程 需要 考虑 以 下 细节 问题 : 

“ 线程 所 处 线程 队列 和 状态 

“ 线程 是 否 为 当前 线程 ， 当 前 线程 是 否 处 于 就 绪 队 列 

“ 线程 优先 级 变化 会 导致 它 会 移动 到 哪些 分 队列 

“ 什么 情况 下 会 引起 线程 调度 


为 了 方便 ， 我 们 首先 假设 内 核 中 就 绪 线程 分 布 情况 如 图 2-13 所 示 。 





注意 为 了 演示 需要 ， 刻 意 在 每 个 队列 尾 加 入 了 一 个 空 的 线程 节点 ， 这 样 可 以 更 形象 地 表示 出 线程 的 队列 和 位 置 迁 移 。 但 在 实际 系统 内 部 ， 不 会 有 这 样 的 空 节点 存在 ; 另外 在 内 核 的 线程 就 绪 队 列 和 辅助 
队列 里 ， 每 个 分 队列 的 节点 都 是 组 织 成 双向 循环 链表 的 。 在 这 里 为 了 图 像 的 清晰 ， 也 省 略 了 队列 头 和 队列 尾 节点 之 间 的 双向 连 线 。 


在 图 2-13 的 演示 中 ， 线 程 Thread31 为 当前 线程 ，Thread32、Thread33 和 它 处 于 同一 个 就 绪 线 程 分 队列 中 。 


uThreadReadyQueue 





~ Tea Ye» Tn ED ET 
Thread132 | 





图 2-13 ”修改 线程 优先 级 演示 1 


我 们 以 图 2-13 为 基准 ， 来 分 析 一 下 内 核 就 绪 线程 队列 中 的 线程 的 优先 级 的 变化 情况 。 首 先 来 分 析 一 下 当前 线程 之 外 的 其 他 最 高 就 绪 优先 级 的 线程 〈 即 图 2-13 中 的 Thread32 和 Thread33 这 样 的 线程 ) 的 
情况 ， 如 果 它 们 的 优先 级 被 修改 ， 那 么 可 能 发 生 的 移动 情况 如 图 2-14 所 示 。 











图 2-14 说 明了 最 高 就 绪 优先 级 的 非 队列 头 的 线程 的 迁移 的 可 能 情况 : 

“ 优先 级 提升 到 更 高 的 级 别 ， 成 为 队列 头 〈 孤 节点 ) ， 抢 占 当 前 线程 ; 

“ 优先 级 降低 到 低级 别 ， 成 为 队列 头 ( 孤 节点 ) ， 不 会 引起 线程 调度 ; 

“ 优先 级 降低 到 低级 别 ， 成 为 队列 尾 ， 不 会 引起 线程 调度 。 

Thread32 节 点 向 NULL1 节 点 的 迁移 过 程 说 明 Thread32 的 优先 级 提高 到 1 ， 因 为 优先 级 为 1 的 队列 为 空 (必须 是 空 的 ) ， 所 以 成 为 该 队列 的 头 节点 ， 并 且 需 要 线程 调度 。 
Thread32 节 点 向 NULL7 节 点 的 迁移 过 程 说 明 Thread32 的 优先 级 降低 到 7， 因 为 优先 级 为 7 的 队列 为 空 ， 所 以 成 为 该 队列 的 头 节点 ， 不 需要 线程 调度 。 

Thread32 节 点 向 NULL5 节 点 的 迁移 过 程 说 明 Thread32 的 优先 级 降低 到 5， 因 为 优先 级 为 5 的 队列 已 经 有 线程 存在 ， 所 以 成 为 该 队列 的 尾 节点 ， 不 需要 线程 调度 。 
Thread33 和 Thread32 唯 一 不 同 的 地 方 就 是 它们 一 个 处 于 队列 尾 ， 一 个 处 于 队列 中 。 当 优先 级 变化 ， 引 起 其 所 属 分 队列 的 变化 的 情况 是 一 样 的 。 


再 来 分 析 一 下 非 最 高 就 绪 优先 级 的 线程 的 情况 ， 因 为 每 个 线程 的 迁移 路 线 都 比较 多 ， 所 以 分 开演 示 某 个 队列 中 不 同位 置 的 节点 的 迁移 情况 。 





如 果 线 程 处 于 队 首 ， 则 其 队列 迁移 如 图 2-15 所 示 。 





UIhreadReadyQnueue 





图 2-14 修改 线程 优先 级 演示 2 


uThreadReadyQueue 


图 2-15 修改 线程 优先 级 演示 3 


非 最 高 就 绪 优先 级 的 线程 ， 如 果 处 于 队 中 ， 则 其 队列 迁移 如 图 2-16 所 示 。 





uThreadReadyQueue 





图 2-16 修改 线程 优先 级 演示 4 


非 最 高 就 绪 有 限 级 的 就 绪 线程 ， 如 果 处 于 队 尾 ， 则 其 队列 迁移 如 图 2-17 所 示 。 


uThreadReadyQueue 








-->|NULLI 





图 2-17 修改 线程 优先 级 演示 5 


图 2-15 至 图 2-17 说 明了 非 就 绪 优 先 级 的 线程 的 迁移 的 可 能 情况 : 





“ 优先 级 提升 到 比 当前 最 高 就 绪 优 先 级 更 高 的 级 别 ， 抢 占 当前 线程 ; 


“ 优先 级 提升 到 当前 最 高 就 绪 优 先 级 ， 成 为 队列 尾 ， 不 会 引起 线程 调度 ; 


“ 优先 级 提升 ， 但 低 于 最 高 的 级 别 ， 成 为 队列 头 〈 孤 节点 ) ， 不 会 引起 线程 调度 ; 

“ 优先 级 提升 ， 但 低 于 最 高 的 级 别 ， 成 为 队列 尾 ， 不 会 引起 线程 调度 ; 

“ 优先 级 降低 到 低级 别 ， 成 为 队列 头 〈 孤 节点 ) ， 不 会 引起 线程 调度 ; 

“ 优先 级 降低 到 低级 别 ， 成 为 队列 尾 ， 不 会 引起 线程 调度 。 

Thread91 节 点 向 NULL1 节 点 的 迁移 过 程 说 明 Thread91 的 优先 级 提高 到 1 ， 因 为 优先 级 为 1 的 队列 为 空 (必须 是 空 的 ) ， 所 以 成 为 该 队列 的 头 节点 ， 并 且 需 要 线程 调度 。 

Thread91 节 点 向 NULL3 节 点 的 迁移 过 程 说 明 Thread91 的 优先 级 提高 到 3， 成 为 当前 最 高 就 绪 优 先 级 ， 因 为 优先 级 为 3 的 线程 队列 不 为 空 ， 所 以 成 为 该 队列 的 尾 节 点 ， 不 需要 线程 调度 。 
Thread91 节 点 向 NULL5 节 点 的 迁移 过 程 说 明 Thread91 的 优先 级 上 升 到 5， 因 为 优先 级 为 5 的 队列 不 为 空 ， 所 以 成 为 该 队列 的 尾 节点 ， 不 需要 线程 调度 。 

Thread91 节 点 向 NULL7 节 点 的 迁移 过 程 说 明 Thread91 的 优先 级 上 升 到 7， 因 为 优先 级 为 7 的 队列 为 空 ， 所 以 成 为 该 队列 的 头 节点 ， 不 需要 线程 调度 。 

Thread91 节 点 向 NULL11 节 点 的 迁移 过 程 说 明 Thread91 的 优先 级 降低 到 11， 因 为 优先 级 为 11 的 队列 已 经 有 线程 存在 ， 所 以 成 为 该 队列 的 尾 节点 ， 不 需要 线程 调度 。 


Thread91 节 点 向 NULL15 节 点 的 迁移 过 程 说 明 Thread91 的 优先 级 降低 到 15， 因 为 优先 级 为 15 的 队列 没有 线程 存在 ， 所 以 成 为 该 队列 的 尾 节点 ， 不 需要 线程 调度 。 





Thread91、Thread93 和 Thread94 唯 一 不 同 的 地 方 就 是 它们 在 队列 中 的 位 置 。 但 当 优先 级 变化 ， 引 起 其 所 属 分 队列 的 变化 的 情况 是 一 样 的 。 


现在 我 们 再 来 看 一 下 ， 当 前 线程 的 优先 级 变化 会 导致 怎么 样 的 线程 分 队列 迁移 。 因 为 当前 线程 并 不 一 定 一 直 处 于 就 绪 队 列 ， 所 以 必须 说 明 这 里 讲 的 是 当前 线程 处 于 就 绪 队 列 的 情况 。 当 前 线程 和 就 绪 线 
程 相 比较 ， 不 同 的 地 方 在 于 当前 线程 在 分 队列 中 迁移 时 ， 是 插入 队列 头 的 ， 即 无 论 它 处 于 哪个 队列 中 ， 都 保持 它 的 队列 头 位 置 不 变 。 而 其 他 的 就 绪 线程 则 是 追加 到 队列 尾 的 。 





我 们 首先 按照 图 2-18 来 演示 当前 线程 的 情况 。 


当前 线程 Thread31 的 优先 级 变化 有 以 下 几 种 情况 ， 因 为 当前 线程 要 放 在 队列 头 ， 所 以 它 的 迁移 情况 比较 简单 ， 如 图 2-19 所 示 。 





Thread31 节 点 向 NULL1 节 点 的 迁移 过 程 说 明 Thread31 的 优先 级 提高 到 1 ，Thread31 成 为 该 队列 的 头 节点 ， 并 且 不 需要 线程 调度 。 
Thread31 节 点 向 Thread51 节 点 前 的 迁移 过 程 说 明 Thread31 的 优先 级 降低 到 5，Thread31 成 为 该 队列 的 头 节点 ， 并 且 需 要 线程 调度 。 


Thread31 节 点 向 NULL7 节 点 的 迁移 过 程 说 明 Thread31 的 优先 级 降低 到 7，Thread31 成 为 该 队列 的 头 节点 ， 并 且 需 要 线程 调度 。 


UIhreadReadyQueue 





图 2-18 ”修改 当前 线程 优先 级 演示 6 


uThreadReadyQueue 





图 2-19 当前 线程 处 于 队列 头 时 修改 优先 级 


另外 ， 程 序 在 执行 用 户 级 线程 调度 时 ， 会 把 当前 线程 调整 到 就 绪 线程 队列 的 队 尾 ; 此 外 在 时 间 节 拍 中 断 处 理 过 程 中 ， 有 时 也 会 把 当前 线程 调整 到 就 绪 线程 队列 的 队 尾 。 在 这 两 种 情况 下 ， 如 果 调整 当前 
线程 的 优先 级 ， 则 当前 线程 的 位 置 的 变化 如 图 2-20 所 示 。 





以 上 讲 的 都 是 被 修改 优先 级 的 线程 处 于 内 核 线程 就 绪 队列 的 情况 。 处 于 阻塞 状态 的 线程 的 优先 级 变化 会 在 第 3 章 详细 介绍 。 而 除了 就 绪 和 阻塞 之 外 的 其 他 状态 的 线程 都 处 于 内 核 线程 辅助 队列 中 ， 没 有 因 
优先 级 引起 的 调度 抢占 关系 ， 优 先 级 变化 也 没有 引起 线程 调度 可 能 。 所 以 可 以 直接 修改 线程 的 优先 级 。 





就 绪 设 定 线程 优先 级 的 整体 流程 如 下 : 
“ 检查 线程 是 否 允 许 修改 优先 级 
“ 判别 线程 状态 ， 区 分 处 理 处 于 不 同 状态 的 线程 的 优先 级 


“ 如 果 是 当前 线程 的 优先 级 被 修改 ， 则 需要 进行 调度 处 理 


ulhreadReadyQueue 





图 2-20 ”当前 线程 处 于 队 尾 时 修改 优先 级 
流程 图 分 析 : 
STEP2 如 果菜 个 线程 没有 配置 成 优先 级 可 设置 ， 那么 对 该 线程 的 操作 会 失败 。 
STEP4 ”处 于 阻塞 状态 的 线程 有 单独 的 函数 来 处 理 。 
STEP5 处 于 就 绪 状 态 的 线程 也 有 单独 的 流程 来 处 理 。 
STEP6 处 于 其 他 状态 的 线程 ， 可 直接 修改 线程 优先 级 。 
STEP9 在 就 绪 线 程 的 处 理 过 程 中 ， 检 查 函 数 是 否 被 线程 调度 并 且 检 查 内 核 是 否 允许 线程 调度 。 
STEP10 ”如果 是 被 线程 调度 的 ， 那 么 计算 最 高 就 绪 优 先 级 。 
STEP11 如 果 最 高 就 绪 优 先 级 比 当前 线程 的 优先 级 还 要 高 ， 那 么 需要 进行 线程 调度 。 
STEP12 向 内 核 申请 线程 调度 。 


STEP13 内核 代 码 退 出 独占 区 后 可 能 发 生 中 断 。 在 中 断 退 出 时 可 能 发 生 线 程 调度 。 


代码 清单 2-12: 线程 优先 级 修改 伪 代 码 





工 ， 
修改 线程 优先 级 
色 


3。 
关闭 中 断 ; 


4. 
如 果 线程 可 以 被 修改 优先 级 
有 





有 
针对 不 同 状态 的 线程 个 改 其 优先 级 
纹 续 处 理 状 态 为 训 结 态 的 线 和 


9.。 

部 轩 是 线程 调用 本 本 数 

内 术 没 有 关闭 线 和 调度 

11 

得 到 当前 就 结 队 列 的 最 高 就 结 优先 级 
如 果 有 更 高 就 优先 级 

124. 


向 内 核 申 请 线程 调度 
15 } 
1 和 
A, 


18. 
打开 中 断 ; 
D9 











3 内 核 进入 独占 区 


13 内 核 退 出 独占 区 


2-21 修改 线程 优先 级 

















2.4.10 ”线程 时 间 片 修改 








在 同 优先 级 的 线程 间 ， 时 间 片 长 度 决定 了 线程 持 有 处 理 器 的 时 间 ， 各 线程 按照 时 间 片 比例 轮流 占用 处 理 器 。Trochili RTOS 实 现 了 线程 时 间 片 修改 的 功能 ， 在 内 核 运行 时 ， 能 够 动态 调用 线程 的 时 间 片 。 














在 修改 线程 时 间 片 时 ， 需 要 检查 线程 是 否 允 许 修改 时 间 片 ， 如 果 可 以 则 直接 修改 。 并 保持 线程 在 它 当前 的 线程 队列 中 ， 同 时 保持 状态 不 变 。 





修改 线程 时 间 片 长 度 的 流程 如 图 2-22 所 示 。 











图 2-22 修改 线程 时 间 片 长 度 











流程 图 分 析 : 





STEP3 ”如果 某 个 线程 没有 配置 成 时 间 片 可 变 ， 那么 对 该 线程 的 时 间 片 调整 操作 会 失败 。 


STEP4 时 间 片 调整 。 


代码 清单 2-13: 修改 线程 时 间 片 伪 代 码 


ls 
修改 线程 时 间 片 
2. 


3 

关闭 中 断 

4. 

如 果 线程 时 间 片 可 以 被 修改 
5. E 


全 
如 果 新 的 时 间 片 大 于 原 有 时 间 片 
了 { 


8. 
修正 本 轮 时 间 片 剩余 计数 算法 1 
) 


2.5 ”系统 守护 线程 









































Trochili RTOS 提 供 了 两 个 系统 守护 线程 ，IDLE 线 程 和 Timer 线 程 。 其 中 IDLE 线 程 是 必 不 可 少 的 。 当 系统 中 没有 用 户 线程 就 绪 时 ， 将 由 它 来 占用 处 理 器 ; 而 Timer 线 程 则 可 以 根据 用 户 需 求 来 剪裁 配 
如 果 用 户 不 需要 定时 操作 那么 可 以 通过 内 核 配 置 文件 取消 用 户 定时 器 功能 。 


































































































1DLE 线 程 同时 是 内 核 多 任务 机 制 的 启动 线程 。 因 为 IDLE 线 程 的 优先 级 被 设置 为 31， 即 最 低 优先 级 ， 所 以 最 后 IDLE 线 程 总 会 被 其 他 线程 抢占 。 启 动 多 任务 之 后 ，IDLE 线 程 的 行为 不 确定 ， 由 用 户 注册 的 
HOOK 函 数 来 定义 ， 一 般 来 说 可 以 做 低 功 耗 等 操作 。 





















































Timer 守 护 线程 用 来 处 理 用 户 回调 类 型 定时 器 的 ， 即 当 用 户 定时 器 计数 结束 时 ，Timer 守 护 线程 会 调用 用 户 定时 器 注册 的 回调 函数 ， 代 理 定时 器 任务 。Timer 守 护 线 程 的 优先 级 默认 为 1。 






































2.6 ”线程 应 用 演示 


本 节 我 们 通过 在 评估 板 上 的 实例 来 演示 有 关 线 程 调度 和 管理 的 APl。 因 


来 演示 代码 的 执行 路 径 。 


2.6.1 ”线程 激活 和 休 眼 演示 


上 面 介绍 了 线程 激活 和 休眠 的 功能 设计 和 API 原型 。 下 面 我 们 就 演示 一 下 这 两 种 功能 如 何 使 有 

















在 下 面 的 例子 中 ， 共 有 三 个 线程 ， 线 程 ThreadLEDOn 





这 三 个 线程 都 进行 了 初始 化 。 但 是 只 激活 了 ThreadCTRL。 所 以 当 内 核 初始 化 结束 后 ，ThreadCTRL 首 先 运行 。 
因为 ThreadCTRL 的 优先 级 高 ， 所 以 该 线程 从 延 时 中 返回 


活 。 





代码 清单 2-14: 线程 激活 和 休眠 


来 保持 LED 设 备 开 












































启 ， 线 程 ThreadLEDOff 








来 保持 LED 设 备 关闭 ， 线 程 ThreadCTRL 则 








为 每 个 例子 中 都 包括 了 线程 的 创建 ， 所 以 这 里 不 再 单独 介绍 如 何 创建 线程 。 示 例 程序 尽量 设计 得 简单 ， 主 要 依靠 评估 板 上 的 LED 灯 


。 我 们 要 实现 的 功能 是 通过 几 个 线程 的 合作 ， 在 Colibri 评 估 板 上 按照 1 秒 的 时 间 间 隔 打 开 和 关闭 LED 设 备 。 

















来 控制 另外 两 个 线程 的 运行 。 在 











户 初始 化 函数 中 ， 对 


ThreadCTRL 线 程 按 照 1 秒 的 时 间 间 隔 进行 延 时 ， 在 延 时 前 后 则 控制 另外 两 个 线程 的 休眠 与 激 
后 立刻 通过 优先 级 抢占 获得 处 理 器 控制 权 ， 从 而 可 以 及 时 地 控制 另外 两 个 线程 的 运行 。 具 体 代码 如 代码 清单 2-14 所 示 。 





1 #include "trochili.h" 

六 #include "example.h" 

3 

4.  #if (EVB EXAMPLE == CH2 THREAD FXAMPLE2) 
5 

6. /* LED 

设备 参数 */ 

7. #define LED ON (1) 

8. #define LED OFF (0) 

9.  #define LED INDEX (2) 

TQ 

un 

用 户 线程 参数 */ 

12. #define THREAD LED STACK SIZE (512) 
13. #define THREAD LED PRIORITY (5) 
14. #define THREAD LED SLICE (20) 
15s 

16. #define THREAD CTRL STACK SIZE (512) 
17. #define THREAD CTRL PRIORITY (4) 
18. #define THREAD CTRL SLICE (20) 
19. 


20。 J 
用 户 线程 定义 */ 


21. static TThread ThreadLEDOnN; 

22. static TThread ThreadLEDOff; 

23. static TThread ThreadcTRL; 

24. 

pC ky 

用 户 线程 堆栈 */ 

26. static TWord ThreadLEDONnStack[THREAD LED STACK SIZE]; 
27. static TWord ThreadLEDOffStack[THREAD LED STACK SIZE]; 
28. static TWord ThreadCTRLStack[THREAD CTRL STACK SIZE]; 
29, 

0s 

线程 LEDOn 

的 线程 函数 */ 

31. static void ThreadLEDOnEntry (voidx pArg) 

32. { 

335 while (eTrue) 

34. { 

35. EVB_LEDControl (LED_INDEX, LED ON); 

36. } 

37。 于 

38 . 

I. F 

线程 LEDOff 


的 线程 函数 */ 

40. static void ThreadLEDOffEntry (void* pArg) 
41. { 

42. while 
43. { 
44. 

45 . } 
46. } 

47. 

有 
线程 CTRL 

的 线程 函数 */ 


(eTrue) 


EVB_LEDControl (LED INDEX, LED OFF); 


49. static void ThreadCTRLEntrY (void* pArg) 
50。 并 

51 while (eTrue) 

52 { 

53. A 

激活 LED 

设备 点 亮 线程 */ 

54. TclActivateThread (&ThreadLPDOn) 
55。 

56 . 和 

控制 线程 延 时 1 

秒 */ 

S37 TclDelayThread (&ThreadCTRL, SEC2TICKS 
58. 

59s Er 

休眠 LED 

设备 点 亮 线程 */ 

60 . TclDeActivateThread (&ThreadLPDOn) 
61. 

62 . 站 

激活 LED 

设备 熄灭 线程 */ 

63 . TclActivateThread (&ThreadLEDOff) 7 
64. 

65. 过 

控制 线程 延 时 1 

秒 */ 

66. TclDelayThread (&ThreadCTRL, SEC2TICKS 
67. 

68. Ee 

休眠 LED 

设备 熄灭 线程 */ 

69 . TclDeActivateThread (&ThreadLPDOff) 
70. } 

11 } 

12 

EE Pk 


用 户 应 用 入 口 函 数 */ 


74. static void EVB LEDAppEntry (void) 
25 二 

76. 人 

配置 使 能 评估 板 上 的 LED 

设备 */ 

77. EVB_ LEDConfig () 7 

78. 

了、 


(1)); 


(1)); 


初始 化 LED 
设备 点 亮 线程 */ 





80 . Tc1lInitThread(&ThreadLEDOn，&ThreadLEDOnEntrY， (void*)NULL, 
$1. ThreadLEDONnStack, THREAD LED STACK SIZE, 
82. THREAD LED PRIORITY, THREAD LED SLICE); 
, 志 基 

84. /* 

初始 化 LED 

设备 炸 灭 线程 */ 

85 . Tc1lInitThread(&ThreadLEDOff，&ThreadLEDOffPntry， (void*)NULL, 
86. ThreadLEDOffStack, THREAD LED STACK SIZE, 
87. THREAD LED PRIORITY, THREAD LED SLICE); 
88. 

9 /* 

初始 化 CTRL 

线程 */ 

90 . TclInitThread(&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
91. ThreadCTRLStack, THREAD CTRL STACK SIZE, 
92. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
93. 

94. /* 

激活 CTRL 

线程 */ 

95. TclActivateThread (&ThreadCTRL); 

96. } 

97. 

98. _/* 

处 理 器 BOOT 

之 后 会 调用 main 

函数 */ 

99. int main (void) 

100. { 

101. 

注册 处 理 器 初始 化 函数 到 内 核 */ 

102. TclSetCpuEntry (&TCL STM32F10xInit); 

103: 

104. A 

注册 板 级 初始 化 函数 到 内 核 */ 

105. TclSetBoardEntry (&EVB_SetupBoard); 

106. 

107。 /人 

注册 板 级 调试 打印 函数 到 内 核 */ 

108: TclSetTraceRoutine (&EVB UartlWriteByte); 

109, 

110. 

注册 用 户 初始 化 函数 到 内 核 */ 

T1414. TclSetUserEntry (&EVB_ LEDAppEntry); 

112. 

113。 人 

启动 内 核 */ 

114. TclStartKernel (); 

TS。 

Ths return 1; 

i117 } 

118, 

119. #endif 





在 Colibri 评 估 板 上 运行 上 面 的 程序 ， 可 以 看 到 板 上 的 LED 灯 按照 1 秒 的 时 间 间 隔 ， 依 次 点 亮 和 熄灭 。3 个 线程 的 运行 时 序 如 图 2-23 所 示 。 


Control 线 程 
LED ON 线程 
LED OFF 线程 








图 2-23 ”三 个 线程 的 运行 时 序 


2.6.2 ”线程 挂 起 和 解 挂 演示 








下 面 的 代码 演示 了 内 核 中 线程 挂 起 和 解 挂 功能 ， 程 序 首先 定义 了 2 个 应 用 线程 ， 一 个 线程 用 来 点 亮 LED， 一 个 线程 用 来 熄灭 LED。 然 后 定义 了 第 三 个 线程 作为 主 控 线程 ， 主 控 线程 的 功能 是 按照 1 的 间隔 
和 固定 的 顺序 ， 分 别 挂 起 和 解 挂 前 面 的 2 个 LED 控 制 线程 ， 实 现 LED 灯 按照 1s 的 间隔 (不 是 很 精准 ) 点 亮 和 熄灭 。 程 序 代码 如 代码 清单 2-15 所 示 。 














代码 清单 2-15: 线程 挂 起 和 解 挂 





#include "example.h" 
#inclugde "trochili.h" 


#if (EVB EXAMPLE 一 CH2_THREAD EXAMPLE3) 


/* LED 
设备 参数 */ 
#define LED ON (1) 
#define LED OFF (0) 
#define LED INDEX (2) 


区 mo wb 


Fo oo -~ 
[= 


EI 
人 4 


#define THREAD LED STACK SIZE (512) 
I #define THREAD LED PRIORITY (5) 
14. #define THREAD LED SLICE (20) 
15. #define THREAD CTRL STACK SIZE (512) 
16. #define THREAD CTRI, PRIORITY (4) 
17. #define THREAD CTRL SLICE (20) 


1 


jx 本 
static TThread ThreadLEDOnN; 
2 static TThread ThreadLEDOff; 
22. static TThread ThreadCTRL; 
3: 
/* 
攻关 线 信 模 定 义 ey 
25. static TWord ThreadLEDOnStack[THREAD LED STACK SIZE]; 
26. static TWord ThreadLEDOffStack [THREAD |] LED STACK SIZE]; 
27. static TWord ThreaqdCTRLStack[THRERAD ( CTRL : STACK SIZE]; 
28. 
9 
点 亮 LED 
的 线程 的 主 函数 */ 
30. static void ThreadLEDOnEntry (void* pArg) 
Ls 未 
C7 while (eTrue) 





{ 
34. EVB_LEDControl (LED INDEX, LED ON); 


36. } 

Ss 

Sh 

熄灭 LED 

的 线程 的 主 函数 */ 

39. static void ThreadLEDOffEntry (Voidx* pArg) 

















40. { 

41. while (eTrue) 

42. { 

43. EVB_LEDControl (LED INDEX, LED OFF); 
44. } 

45. } 

46. 

47. 

外 这 二 他 的 主 卫 数 二 

48. static void ThreadCTRLENtry (void* pArg) 
49. { 

50 . 


挂 起 两 个 LED 
制 线程 */ 
TclSuspendThread (&ThreadqLEDOn) 





TclSuspendThread (&ThreadLEDOff) 7 

5 

54. while (eTrue) 

S59, { 

56 . 

唤醒 LED 

点 亮 线程 */ 

SE TclResumeThread (&ThreadLEDON); 
58: 

59、 a 

控制 线程 休眠 1 

秒 */ 

60. TclDelayThread (&ThreadCTRL， SEC2TICKS (1)); 
61. 

62 . 2 

挂 起 LED 

点 亮 线程 */ 

63。 TclSuspendThread (&ThreadLEDON); 
64. 

65. /A 

唤醒 LED 

熄灭 线程 */ 

66. TclResumeThread (&ThreadLEDOff) 
67. 

68 . 和 

控制 线程 休眠 1 

秒 */ 

69. TclDelayThread (&ThreadCTRL， SEC2TICKS (1)); 
70. 

71. /* 

挂 起 LED 

熄灭 线程 */ 

2 TclSuspendThread (&ThreadLEDOff) ; 
3 

74. } 

5 


了 
用 户 应 用 入 口 函数 */ 
77. static void EVB LEDAppEntry (void) 


78。 1 

9 本 

配置 使 能 评估 板 上 的 LED 

设备 */ 

80. EVB LEDConfig(); 

81. 

ds J 

初始 化 LED 

设备 控制 线程 

3 TclInitThread (&ThreadLEDON, &ThreadLEDONEnNtry, (void*)NULL, 
84. ThreadLEDONnStack, THREAD LED STACK SIZE, 
85 . THREAD LED PRIORITY, THREAD LED SLICE); 

86. 

87 Lay 

初始 化 LED 

设备 控制 线程 */ 

88. TclInitThread (&ThreadLEDOff, &ThreadLEDOffEntry, (void*)NULL, 
89 . ThreadLEDOffStack，THREAD LED STACK SIZE, 
90. THREAD LED PRIORITY, THREAD ] LED ) SLICE); 

8: 

Bs 人 

初始 化 CTRL 

线程 */ 

93. TclInitThread (&ThreadCTRL， &ThreadCTRLENtry, (void*)NULL, 
94. ThreadCTRLStack, THREAD CTRL STACK SIZE, 
95. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
96. 


97. A 


性 */ 
TclActivateThread (&ThreadLEDOn) 7 


/* 


性 */ 
TclActivateThread (&ThreadLEDOff) 7 





jw 
E 控 线程 */ 
TclActivateThread (&gThreadCTRL); 
} 


ea pA 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提 供 * 
108. int main (void) 
W093; 1 

TD 








注册 处 理 器 初始 化 函数 到 内 核 */ 


1s TclSetCpuEntry (&TCL STM32F10xInit); 
112. 

113: 和 

注册 板 级 初始 化 函数 到 内 核 */ 

114. TclSetBoardEntry (&EVB_ SetupBoard) 7 
i15s 

116. We 

注册 板 级 调试 打印 函数 到 内 核 */ 

1L17, TclSetTraceRoutine (&EVB UartlWriteByte); 
118. 

119 Vy 

注册 用 户 初始 化 函数 到 内 核 */ 

120 . TclSetUserEntry (&EVB LEDAppEntry); 
21s 

122. 

启动 内 核 */ 

1235 TclStartKernel (); 

124. 

125, return 1; 

126. } 

127. #endif 





上 面 的 程序 的 执行 如 图 2-24 所 示 。 


Oe contol 线 可 
LED ON 线程 
LED OFF 线程 





后 


1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 








图 2-24 ”三 个 线程 的 运行 时 序 











注意 ”因为 控制 线程 也 占用 了 运行 时 间 ， 所 以 其 他 2 个 线程 并 不 是 完全 准确 地 按照 1s 来 点 亮 和 熄灭 LED。 


2.6.3 ”线程 延 时 演示 


我 们 以 Colibri 评 估 板 为 例 ， 下 面 的 代码 演示 了 如 何 使 用 线程 延 时 API。 我 们 的 目标 是 在 评估 板 上 通过 一 个 LED 线 程 不 停 地 实现 1 秒 的 延 时 ， 延 时 结束 后 点 亮 或 者 熄灭 [ED， 使 得 LED 灯 呈现 点 亮 -熄灭 的 闪 
烁 效果 。 具 体 代码 如 代码 清单 2-16 所 示 。 


代码 清单 2-16: 线程 延 时 





1. #include "example.h" 
2. #include "trochili.h" 
了 

4. #if (EVB EXAMPLE == CH2 THREAD EXAMPLE4) 
5 

6。 /* LED 

设备 参数 */ 

7. #define LED ON (1) 
8. #define LED OFF (0) 
9. #define LED INDEX (1) 
TOs 

1 


创建 线程 时 需要 的 参数 */ 

12. #define THREAD LED STACK SIZE (256*2) 
13. #define THREAD LED PRIORITY {SY 

14. #define THREAD LED SLICE (65535) 
让 

he 

线程 定义 */ 

17. static TThread ThreadLED; 

18, 人 

线程 栈 定义 */ 

19. static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
20. 

21. /* LED 

线程 的 线程 函数 */ 

22. static void ThreadLEDEntry (void* pArg) 


23. { 

24. while (eTrue) 

25. { 

26. EVB LEDControl (LED INDEX, LED ON); 

27. TclDelayThread (uThreadCurrent, SEC2TICKS (1)); 
28. EVB LEDControl (LED INDEX, LED OFF); 

29. TclDelayThread (uThreadCurrent, SEC2TICKS (1) ) 7 
30 . } 

30: 六 

32: 


> 
用 户 应 用 入 口 函 数 */ 
34. static void EVB LEDAppEntry (void) 


35. { 
36. Wa 
配置 使 能 评估 板 上 的 LED 
设备 */ 




















7s EVB_LEDConfig(); 
38. 
39。 人 
初始 化 LED 
设备 控制 线程 */ 
40. TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
41. ThreadLEDStack, THREAD LED STACK SIZE, 
42. THREAD LED PRIORITY, THREAD LED SLICE); 
43. 
44. Ue 
激活 LED 
设备 控制 线程 */ 
45. TclActivateThread (&ThreadLED); 
46. 1} 
47. 
二 时 汪 
处 理 器 BOOT 
之 后 会 调用 main 
函数 ， 必 须 提 供 */ 
49. int main (void) 
50. { 
SLs pe 
注册 处 理 器 初始 化 函数 到 内 核 */ 
Se TclSetCpuEntry (&TCL STM32F10xInit); 
53。 
54. he 
注册 板 级 初始 化 函数 到 内 核 */ 
5: TclSetBoardEentry (&EVB_SetupBoard); 
56. 
57 . 六 
注册 板 级 调试 打印 函数 到 内 核 */ 
58 . TclSetTraceRoutine (&EVB Uart1lWriteByte); 
9 
60 . 
注册 用 户 初始 化 函数 到 内 核 */ 
Ghs TclSetUserEntry (&EVB_ LEDAppEntry); 
62 . 
63 . pe 
启动 内 核 */ 
64. TclStartKernel (); 
65. 
66. return 1; 
B67 汇 
68. 
69. #endif 
程序 运行 结果 如 图 2-25 所 示 。 
1 1 1 1 1 1 1 1 1 1 
1 1 1 1 1 1 1 1 1 1 LED ON 
1 1 1 1 1 1 1 1 1 1 
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2.6.4 ”线程 主动 调度 演示 








我 们 以 Colibri 评 估 板 为 例 ， 代 码 清单 2-17 演 示 了 如 何 使 用 该 API。 我 们 的 




















我 们 需要 在 
处 理 器 控制 权 交 给 另 一 个 线程 ， 从 而 实现 两 个 LED 控 制 线程 的 交互 运行 。 ( 




















T5 


6. 1 


图 2-25 ”代码 清单 2-16 的 运行 结果 


























标 是 在 评估 板 上 通过 两 个 独立 线程 (分别 








户 初始 化 函数 里 初始 化 并 激活 两 个 线程 。 在 这 两 个 线程 函数 里 ， 它 们 首先 点 亮 或 者 粕 灭 LED， 然 后 延 时 一 段 时 间 再 调 











于 点 亮 和 熄灭 LED) 的 合作 ， 使 得 某 个 LED 灯 呈现 点 亮 -熄灭 的 闪烁 效果 。 














就 绪 队 列 的 头 指 针 会 下 移 到 另 一 个 LED 控 制 线程 ) 。 注 意 这 两 个 LED 控 制 线程 的 时 间 片 都 设置 到 最 大 ， 意 味 着 ， 如 果 不 调 有 


会 出 现 点 亮 -熄灭 的 闪 灯 效果 。 


代码 清单 2-17: 线程 主动 发 起 调度 









































系统 API 函 数 TclYieldThread () ， 那 么 每 次 调 








， 当 前 线程 都 会 把 





为 另外 两 个 LED 控 制 线程 的 优先 级 相同 ， 所 以 它们 在 同样 的 就 绪 队 列 里 。 那 么 当 其 中 一 个 线程 的 时 间 片 运行 结束 后 ， 它 们 所 处 的 


TclYieldThread () 函数 ， 另 一 个 线程 在 很 长 时 间 内 都 不 会 获得 运行 机 会 ， 也 就 不 





1. #include "example.h" 
2. #include "trochili.h" 
3 

4 #if (EVB EXAMPLE 一 CH2_ THREAD EXAMPLES5) 
5 

6. /* LED 

设备 参数 */ 

7. #define LED ON (1) 
8. #define LED OFF (0) 
9. #define LED INDEX (1) 
10. 


A 
创建 线程 时 需要 的 参数 */ 


he 
Ls 
14. 
J 
16 


Ei 
18. 
A 


#define THREAD LED STACK SIZE (256*2) 
#define THREAD LED PRIORITY (5) 
#define THREAD LED SLICE (Oxffffffff) 


rr 
线程 定义 */ 


static TThread ThreadLEDOnN; 
static TThread ThreadLEDOff; 
/* 


线程 栈 定义 */ 





20. static TWord ThreadLEDOnStack [THREAD LED STACK SIZE]; 
21. static TWord ThreadLEDOffStack[THREAD LED STACK SIZE]; 
人 

ec 

线程 做 无 用 操作 ， 起 到 空转 效果 */ 

24. static Delay (TWord count) 

A 

26. while (count -—-); 

Sl 

28. 

9 汪 

线程 LEDOn 

的 线程 函数 */ 

30. static void ThreadLEDOnEntry (void* pArg) 
313 4 

人 while (eTrue) 

3 

34 . EVB_LEDControl (LED INDEX, LED ON) 
35。 Delay (OxFFFFF); 

S36 TclYieldThread (); 

37. J 

8 于 

9 

40. 7 

线程 LEDOff 

的 线程 函数 */ 

41. static void ThreadLEDOffEntry (void* pArg) 
42. { 

43. while (eTrue) 

44. 

45 . EVB_LEDControl (LED INDEX, LED OFF); 
46. Delay (OxFFFFF); 

47. TclYieldThread () 7 

48 . J 

49. 1} 

50 . 

oY 

用 户 应 用 入 口 函 数 */ 

52. static void EVB LEDAppEntry (void) 

S45 站 

54 和. 

配置 使 能 评估 板 上 的 LED 

设备 */ 

与 5: EVB LEDConfig(); 

56 . Ss 

57。 天 二 

初始 化 LED 

设备 控制 线程 */ 

5 TclInitThread (&ThreadLEDON, &ThreadLEDONEnNtry, (void*)NULL, 
$9. ThreadLEDONnStack, THREAD LED STACK SIZE, 
60. THREAD LED PRIORITY, THREAD LED SLICE); 
61. 

62 . 站 

初始 化 LED 

设备 控制 线程 */ 

63 . TclInitThread (&ThreadLEDOff, &ThreadLEDOffEntry, (void*)NULL, 
64. ThreadLEDOffStack, THREAD LED STACK SIZE, 
65. THREAD LED PRIORITY, THREAD LED SLICE); 
66. 

67. 六 

激活 LED 

设备 控制 线程 */ 

68. TclActivateThread (&ThreadLEDOnN); 

69. 

0。 1 

激活 LED 

设备 控制 线程 */ 

Is TclActivateThread (&ThreadLEDOff£); 

2. 

73. 

了 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

75. int main (void) 

76. { 

7 Ls 

注册 处 理 器 初始 化 函数 到 内 核 */ 

78 TclSetCpuEntry (&TCL STM32F10xInit); 

80. ty 

注册 板 级 初始 化 函数 到 内 核 */ 

81 TclSetBoardEentry (&EVB_SetupBoard); 

82. 

83. 

注册 板 级 调试 打印 函数 到 内 核 */ 

84 TclSetTraceRoutine (&EVB UartlWriteByte); 
85. 

86. ds 

注册 用 户 初始 化 函数 到 内 核 */ 

7 TclSetUserEntry (&EVB_ LEDAPPEntrY) 7 

88. 

89. a 

启动 内 核 */ 

90 TclStartKernel () 7 

91, 

ov return 1; 

93; 守 

94. 

95. #endif 











程序 运行 过 程 如 图 2-26 所 示 。 
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2.6.5 ”线程 优先 级 修改 演示 


我 们 以 Colibri 评 估 板 为 例 ， 下 面 的 代码 演示 了 如 何 使 用 


单 2-18 所 示 。 


代码 清单 2-18: 修改 线程 优先 级 








网 


2-26 











代码 清单 2-17 运 行 结果 


该 API。 我 们 的 目标 是 在 评估 板 上 通过 两 个 独立 线程 的 优先 级 变动 ， 来 实现 两 个 LED 按 照 先后 顺序 各 自 





时 间 





闪烁 两 次 ， 并 循环 往复 。 具 体 代 码 如 代码 清 





设备 参数 */ 


#define LED ON (1) 
#define LED OFF (0) 
#define LED INDEX1 (1) 
10. #define LED INDEX2 (2) 
11; 
12. 


Bc 了 
创建 线程 时 需要 的 参数 */ 


14. #define THREAD LED STACK SIZE (256*2) 
15. #define THREAD LED PRIORITY (5) 
16. #define THREAD LED SLICE (OxFFFFFFFF') 


18. 

线程 定义 */ 

19. static TThread ThreadLED1” 
20. static TThread ThreadLED2; 
i 

线程 栈 定义 */ 


Ls #inclugde "trochili.h" 

2。 #include "example.h" 

当 。 

4. #if (EVB EXAMPLE 一 CH2_THRPRAD EXAMPLE6) 
5s 

6 /* LED 

设 

7 

8. 

9。 


22. static TWord ThreadLED1Stack[THREAD LED STACK SIZE]; 
23. static TWord ThreadLED2Stack[THREAD LED STACK SIZE]; 


24. 
25。 全 
线程 做 无 用 操作 ， 起 到 空转 效果 */ 


26. 








static Delay (TWord count) 
7 1 
28. while (Count--) 7 
28 
30 . 
3 
线程 LED1 
的 入 口 函数 */ 
32. static void ThreadLED1Entry (void* pArg) 
33。 { 
34. TByte turn = 0; 
35. while (eTrue) 
36. { 
村 EVB LEDControl (LED INDEX1, LED ON) 
38. Delay (OxFFFFFF); 一 
39s EVB LEDControl (LED INDEX1, LED OFF); 
40. Delay (OxFFFFFF); 一 
41. trn + 
42. if (turn == 2) 
43. { 
44. TclSetThreadPriority (&ThreadLED2, 
45. turn = 0} 
46. } 
47. } 
48. } 
49. 
0 A 
线程 LED2 
的 入 口 函数 */ 
51. static void ThreadLED2Entry (void* pArg) 
52. { 
x TByte turn = 0; 
54. while (eTrue) 
5 { 
56 . EVB LEDControl (LED INDEX2, LED ON) 
57。 Delay (OxFFFFFF); 一 二 
58. EVB_ LEDControl (LED INDEX2, LED OFF); 
59; Delay (OxFFFFFF); ~ 
60. es 二 中 
61. if (turn == 2) 
62 . { 
63 . TclSetThreadPriority(&ThreadLED2， 
64. turn = 0F 
65. L 
66. } 


THREAD LED PRIORITY - 1); 


THREAD LED PRIORITY + 1 ); 


68 . 

Bas A 

用 户 应 用 入 口 函 数 */ 

70. static void EVB LEDAppEntry (void) 








了 1。 { 

72 . 人 

配置 使 能 评估 板 上 的 LED 

设备 */ 

是 3 EVB LEDConfig () 7 

74. 

75。 

初始 化 LED1 

设备 控制 线程 */ 

1 TclInitThread(&ThreadLED]1, &ThreadLEDlEnNntry, (void*)NULL, 
Ts ThreadLED1Stack, THREAD LED STACK SIZE, 
78. THREAD LED PRIORITY, THREAD LED SLICE); 
了。 

80 . 这 

初始 化 LED2 

设备 控制 线程 */ 

81. Tc1lInitThread(&ThreadLED2，&ThreadLED2Entry， (void*)NULL, 
82s ThreadLED2Stack, THREAD LED STACK SIZE, 
3 THREAD LED PRIORITY + 1, THREAD LED SLICE); 
84. 

85 . 

激活 LED1 

设备 控制 线程 */ 

86. TclActivateThread (&ThreadLED1) ; 

87 . 

88 . Fi 

激活 LED2 

设备 控制 线程 */ 

89. TclActivateThread (&ThreadLED2); 

90. } 

1 

9 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

93. int main (void) 

94. { 

55。 党 

注册 处 理 器 初始 化 函数 到 内 核 */ 

96 . TclSetCpuEntry (&TCL STM32F10xInit); 

97。 

98 . 

注册 板 级 初始 化 函数 到 内 核 */ 

99 . TclSetBoardEntry (&EVB_ SetupBoard) 7 

100 . 

101 . 

注册 板 级 调试 打印 函数 到 内 核 */ 

102., TclSetTraceRoutine (&EVB UartlWriteByte); 
103; 

104. /* 

注册 用 户 初始 化 函数 到 内 核 */ 

105, TclSetUserEntry (&EVB LEDAppEntry); 

106. 

107. 

启动 内 核 */ 

108. TclStartKernel (); 

109. 

i110 return 1; 

111. } 

12。 

LL3 

114. #endif 





程序 运行 结果 如 图 2-27 所 示 。 
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2-27 ”代码 清单 2-18 运 行 结果 








网 








2.6.6 ”线程 时 间 片 修改 演示 








我 们 以 Colibri 评 估 板 为 例 ， 下 面 的 代码 演示 了 如 何 使 用 该 APl。 我 们 的 目标 是 在 评估 板 上 通过 三 个 独立 线程 的 时 间 片 的 变动 ， 来 实现 LED 亮 / 暗 的 不 同 占 空 比 。 也 就 是 说 LED 的 点 亮 时 间 和 熄灭 时 间 的 长 
短 比例 是 变化 的 。 具 体 代码 如 代码 清单 2-19 所 示 。 








回 




















代码 清单 2-19: 修改 线程 时 间 片 





LE #include "trochili.h" 

吕 、 #include "example.h" 

3 

4.  #if (EVB EXAMPLE == CH2 THREAD FXAMPLE7) 
5 

6.  _/* LED 

设备 参数 */ 

7.  #define LED ON (1) 

8. #define LED OFF (0) 

9.  #define LED INDEX (2) 

10. 

eh eo de 

创建 线程 时 需要 的 参数 */ 

12. #define THREAD LED STACK SIZE (256*2) 
13. #define THREAD LED PRIORITY 5) 

14. #define THREAD LED SLICE 100) 


( 
( 
( 
15. #define THREAD LED SLICE MAX (400) 
( 
( 
( 


16. #define THREAD CTRL STACK SIZE (256*2) 
17. #define THREAD CTRL PRIORITY 5) 
18. #define THREAD CTRL SLICE 100) 


9s 

Sa 

线程 定义 */ 

21. static TThread ThreadLEDOnN; 

22. static TThread ThreadLEDOff; 

23. static TThread ThreadCTRL; 

24. 

RB EY 

线程 栈 定义 */ 

26. static TWord ThreadLEDOnStack[THREAD LED STACK SIZE]; 
27. static TWord ThreadLEDOffStack[THREAD LED STACK SIZE]; 
28. static TWord ThreadcTRLStack[THREAD CTRL STACK SIZE]; 
295 

3 

线程 LEDOn 

的 线程 函数 */ 

31. static void ThreadLEDOnEntry (void* pArg) 
32%.. 

也 while (eTrue) 

34. t 

了 EVB_LEDControl (LED INDEX, LED ON); 
36. } 

Si | 

38. 

- 

线程 LEDOff 

的 线程 函数 */ 

40. static void ThreadLEDOffEntry (void* pArg) 
41. { 

42. while (eTrue) 

43. { 

44. EVB_LEDConNntrol (LED INDEX, LED OFF); 
45. } 

46. } 

47. 

4 

线程 CTRL 

的 线程 函数 */ 

49. static void ThreadCTRLEntrY (void* pArg) 


3 

SE, static TTimerTick slice = THREAD LED SLICE; 
Se while (eTrue) 

53 . { 

54. TclSetThreadSlice (&gThreadLEDOnN, slice); 
55. if (slice < THREAD LED SLICE MAX) 

56 . { 

ya slice += THREAD LED SLICE; 

58: 下 

5 else 

60 . { 

BL: slice = THREAD LED SLICE; 

62. } 

63. 

64. TclYieldThread (); 

65. } 

66. } 

67. 


BS 

用 户 应 用 入 口 函数 */ 

69. static void EVB_LEDAPPEntry (void) 

3 了 0 

村 > 

配置 使 能 评估 板 上 的 LED 

设备 */ 

72 EVB_LEDConfig () 7 

3。 

74. A* 

初始 化 CTRL 

线程 */ 

和 TclInitThread(&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
A ThreadCTRLStack, THREAD CTRL STACK SIZE, 
ps THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
78. 

79., A 

初始 化 LED 

设备 控制 线程 */ 

80. TclInitThread(&ThreadLEDOnNn, &ThreadLEDONENtry, (void*)NULL, 
81. ThreadLEDOnStack, THREAD LED STACK SIZE, 
82. THREAD LED PRIORITY, THREAD LED SLICE); 
83. 

84. A 

初始 化 LED 

设备 控制 线程 */ 

95 TclInitThread (&ThreadLEDOff, &ThreadLEDOffEntry, (void*)NULL, 
ThreadLEDOffStack, THREAD LED STACK SIZE, 
THREAD LED PRIORITY, THREAD LED SLICE); 


TclActivateThread (&gThreadCTRL); 





/* 
设备 控制 线程 */ 

3 TclActivateThread (&ThreadLEDON); 
94. 

5 /* 

激活 LED 

设备 控制 线程 */ 

dy TclActivateThread (&ThreadLEDOff) 7 
7 六 

98 . 

SR 

处 理 器 BOOT 

之 后 会 调用 main 


函数 ， 必 须 提供 */ 


100. int main (void) 


101. { 

102 . A 

注册 处 理 器 初始 化 函数 到 内 核 */ 

03 TclSetCpuEntry (&TCL STM32F10xInit); 
104. 

05 /A 

注册 板 级 初始 化 函数 到 内 核 */ 

106 . TclSetBoardEntry (&EVB_SetupBoard); 
107. 





108. A 
注册 板 级 调试 打印 函数 到 内 核 */ 


109, TclSetTraceRoutine (&EVB UartlWriteByte); 
te 
注入/ 和 化 要 村 二 

TclSetUserEntry (&EVB LEDAppEntry); 


1 

114. i 

局 动 内 核 #/ 
TclStartKernel (); 

1 

TY return 1; 

il9. } 


119, 
120. #engdif 























可 以 通过 图 2-28 的 演示 来 理解 上 述 代 码 ， 三 个 线程 拥有 相同 的 优先 级 ， 轮 流 执行 ， 每 次 轮 到 控制 线程 运行 时 都 会 把 LEDOn 线 程 的 时 间 片 增加 1 秒 ， 直 到 增加 到 指定 的 最 大 值 后 才 返 回 1 秒 。 






































IO Il T2 T3 TI4 T5316 TI7 TS8 








2-28 代码 清单 2-19 图 解 




















第 3 章 ”线程 同步 和 通信 


在 赃 入 式 系统 中 运行 的 代码 主要 包括 线程 和 ISR， 在 它们 的 运行 过 程 中 ， 它 们 的 运行 步骤 有 时 需要 同步 ， 它 们 的 访问 资源 有 时 需要 互 斥 ， 它 们 之 间 有 时 也 要 彼此 交换 数据 。 这 些 需求 ， 有 的 是 因为 应 用 需 
求 ， 有 的 是 多 任务 编程 模型 带 来 的 需求 。 因 此 操作 系统 必须 提供 相应 的 机 制 来 完成 这 些 功 能 。 在 这 里 把 这 些 机 制 统称 为 进 ( 线 ) 程 间 通 信 (Internal Process Communication，IPC) ， 常 见 的 机 制 主要 包括 信和 号 
、 消 息 队列 、 邮 箱 、 事 件 标记 、 管 道 、 信 号 和 条 件 变 量 等 。 


十 


Trochili RTOS 目 前 支持 的 IPC 机 制 包括 信号 量 、 互 斥 量 、 邮 箱 、 消 息 队 列 和 事件 标记 。 在 设计 IPC 机 制 时 ， 在 对 这 几 种 IPC 机 制 仔细 分 析 后 ， 我 发 现在 线程 的 阻塞 和 数据 的 传输 流程 上 ， 有 很 多 相似 的 地 
方 ， 可 以 设计 一 套 比 较 完整 通用 的 代码 作为 IPC 模 块 的 基础 。 本 章 主要 分 析 这 些 IPC 机 制 的 底层 通用 函数 和 数据 结构 


3.1 ”线程 阻塞 队列 


首先 考虑 一 下 线程 队列 的 问题 。 前 面 有 关 线 程 的 章节 中 ， 定 义 了 两 个 内 核 线程 队列 : 内 核 线程 就 绪 队列 和 内 核 线程 辅助 队列 。 在 IPC 部 分 ， 我 们 又 定义 了 另 一 种 类 型 的 线程 队列 : 线程 阻塞 队列 。 各 类 型 
的 IPC 对 象 ， 均 带 有 线程 阻塞 特性 ， 需 要 保存 那些 因 IPC 操 作 失 败 而 不 得 不 等 待 |PC 条 件 满足 的 线程 ， 而 线程 阻塞 队列 正 是 用 来 实现 这 个 功能 的 。 




















在 Trochili RTOS 中 ，IPC 线 程 阻塞 队列 定义 在 文件 ipc.h 中 。 和 其 他 RTOS 相 比 ， 这 个 线程 阻塞 队列 实现 有 自己 的 特点 : 线程 阻塞 队列 中 设计 了 两 个 线程 阻塞 分 队列 。 这 样 做 的 理由 是 像 邮箱 、 消 息 队 列 
的 功能 里 ， 会 把 数据 分 为 紧急 和 一 般 的 消息 /邮件 ， 所 以 需要 分 别 保存 到 不 同 的 队列 中 。 如 果 同 时 有 紧急 数据 和 普通 数据 到 达 ， 内 核 优先 考虑 的 是 紧急 数据 。 而 同样 类 型 的 数据 ， 比 如 都 是 普通 消息 或 者 都 是 
紧急 消息 ， 那 就 既 可 以 按照 FIFO 机 制 来 处 理 ， 也 可 以 按照 发 送 数据 线程 的 优先 级 机 制 来 处 理 。 线 程 阻塞 队列 结构 如 代码 清单 3-1 所 示 。 














代码 清单 3-1: 线程 阻塞 队列 结构 定义 





Ls FIPC 

线程 阻塞 队列 结构 定义 */ 

2. struct IPCBlockedQueueDef 
于 


TProperty* Property; Fd 
ea 站 
inkNode* PrimaryHandle; 有 
队列 中 基本 级 池 Pe ed 


nkNode* A Fd 


Doma 站 分 队列 * 7 





“ Property 宿 主 属性 参数 指针 : 指向 具体 IPC 对 象 的 属性 字段 ， 在 属性 字段 中 ， 会 有 分 队列 的 调度 策略 的 参数 ， 指 明 两 个 分 队列 按照 哪 种 方式 来 调度 : FIFO 或 者 线程 优先 级 。 


“ PrimaryHandle 队 列 中 基本 线程 分 队列 : 没有 特殊 要 求 的 线程 会 阻塞 在 这 个 队列 中 。 


:AuxiliaryHandle 队 列 中 辅助 线程 分 队列 : 在 该 队列 中 阻塞 的 线程 会 被 特殊 处 理 。 








通过 这 几 个 成 员 ， 针 对 线程 的 优先 级 、 数 据 的 特性 ， 用 户 可 以 对 每 个 IPC 对 象 做 出 最 符合 应 用 的 配置 。 图 3-1 基 于 信号 量 的 结构 演示 了 1PC 线 程 阻塞 队列 结构 。 


Semaphore 














图 3-1 信号 量 的 线程 阻塞 队列 演示 





3.2 ”线程 阻塞 记录 


前 面 曾经 提 到 过 ， 在 线程 结构 中 有 一 个 IpcRecord 成 员 ， 当 线程 因 操作 IPC 对 象 不 能 完成 时 ， 有 时 需要 阻塞 在 IPC 对 象 的 线程 阻塞 队列 上 ， 而 此 时 需要 记录 该 线程 在 线程 阻塞 队列 上 的 阻塞 情况 。 包 括 被 
操作 的 IPC 对 象 类 型 和 地 址 ， 操 作 时 的 参数 以 及 用 于 传递 数据 的 指针 。 这 些 信息 都 保存 在 lpcRecord 结 构 中 。 该 成 员 的 结构 定义 如 代码 清单 3-2 所 示 。 





代码 清单 3-2: IPC 阻 塞 记录 结构 定义 








Ls 
J 
线程 用 于 记 . 
对 象 的 详细 区 日 前 记录 结构 2 
人 2。 struct IpcRecordDef 
3. { 
4. void* Resource; * 
指向 IPC 
对 象 地 址 的 指针 2 
5。 TIpcQueue* Queue; ve 
线程 所 属 IPC 
线程 队列 指针 wy 
6. TIpcData Data; Vs 
和 IPC 
对 划 操 作 相 关 的 数据 指针 守 
Ys TOption Option; Fa 
访问 IPC 
对 象 的 操作 参数 wy 
8. TState State; A* TPR 
对 象 操作 的 返回 从 Sy 
多 Errno; /* IPC 
对 包 操 作 的 错误 代 大 "9 id 
10. 


Ea 
11. typedef struct IpcRecordDef TIpcRecord; 





“ Resource: 被 操作 的 IPC 对 象 的 地 址 。 

:Queue: 线程 所 在 的 IPC 的 线程 阻塞 队列 地 址 。 

“ Data: 如 果 线 程 需要 交互 数据 ， 则 这 个 变量 指向 线程 待 传输 数据 的 地 址 。 

“ Option: 记录 IPC 操 作 的 参数 ， 比 如 是 否 有 时 限 要 求 ， 是 否 在 辅助 阻塞 队列 中 。 
“State: 线程 操作 IPC 的 结果 ， 可 能 是 成 功 、 失 败 、 被 取消 、 被 取消 初始 化 等 。 


“ Errno: IPC 对 象 操作 的 错误 代码 。 


图 3-2 演 示 了 线程 访问 信号 量 时 的 阻塞 情况 。 


Ta 
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图 3-2 ”信号 量 的 线程 阻塞 现场 








从 图 3-2 中 我 们 可 以 看 到 : 





“ 信号 量 的 结构 中 有 一 个 线程 阻塞 队列 。 
“ 线程 阻塞 队列 的 Property 直 接 指向 信号 量 的 Property 参 数 。 
“ 线程 阻塞 队列 中 的 基本 队列 中 有 两 个 线程 被 阻塞 。 


' 被 阻塞 线程 通过 IpcRecord 记 录 下 当前 操作 的 信号 量 的 地 址 、 阻 塞 队列 的 地 址 。 所 在 阻塞 队列 的 分 队列 由 IpcRecord 的 Option 成 员 记 录 。 


3.3 1PC 机 制 底层 支撑 函数 





当 线 程 以 阻塞 方式 访问 一 个 IPC 对 象 时 ， 如 果 操 作 不 能 立刻 成 功 ， 那 么 这 个 线程 就 要 被 阻塞 了 。 访 问 每 种 类 型 的 |PC 对 象 的 机 制 是 不 一 样 的， 但 阻塞 时 的 流程 却 都 差不多 。 需 要 几 个 函数 配合 来 完成 具体 
的 阻塞 操作 。 线 程 阻塞 -解除 阻塞 的 过 程 如 下 描述 : 


“ 首先 是 线程 发 起 IPC 操 作 ， 但 操作 不 能 成 功 。 

“ 此 时 需要 保存 当前 访问 的 [PC 信息 ， 如 果 是 消息 传递 类 型 的 [PC 对 象 ， 还 要 保存 被 传递 (发 送 和 接收 ) 的 数据 变量 的 地 址 。 

“ 然后 当前 线程 的 状态 会 被 设置 为 阻塞 态 ， 并 且 会 从 内 核 线程 就 绪 队 列 移入 线程 阻塞 队列 。 如 果 需 要 ， 还 会 立刻 发 出 线程 调度 。 

: 当 IPC 对 象 满足 那些 被 阻塞 的 线程 时 ， 就 需要 选择 其 中 一 个 最 恰当 的 线程 解除 阻塞 ， 如 果 需 要 ， 还 要 把 数据 传 给 那个 刚 被 解除 阻塞 的 线程 。 


“ 等 到 该 线程 再 次 被 调度 时 ， 它 会 检查 本 次 IPC 操 作 的 结果 并 随后 清除 IpcRecord 记 录 。 

















本 模块 的 函数 基本 都 是 IPC 机 制 的 内 部 支持 函数 ， 这 些 函 数 只 会 被 各 IPC 功 能 的 代码 来 调用 ， 并 不 直接 面向 用 户 ， 也 不 会 被 API 层 直接 调用 。 主 要 包括 以 下 几 个 函数 ( 见 表 3-1) 。 























表 3-1 IPC 底 层 支持 函数 列表 


作用 
初始 化 线程 阻塞 队列 
保存 IPC 对 象 操作 的 信息 到 线程 结构 
清除 IPC 对 象 操作 的 信息 
获得 IPC 对 象 访问 的 结果 
将 当前 线程 阻塞 在 线程 阻塞 队列 上 
将 阻塞 队列 上 的 指定 线程 正常 解除 阻塞 


ulpcUnblockOptimalThread 在 阻塞 队列 上 选择 一 个 合适 的 线程 并 解除 阻塞 


msT 
| 
2 | sme | 
| ee | 
| ese | 
3 | wo | 
5 | ua | 
7 | poi | 
ET 
| eo | 
| pe 
Ti ws | 


3.3.1 ”线程 阻塞 队列 初始 化 











函数 ulpclnitQueue () 用 来 清空 队列 的 两 个 分 队列 头 ， 然 后 将 队列 的 











3.3.2 ”保存 线程 阻塞 信息 


将 阻塞 队列 上 的 所 有 线程 解除 阻塞 
将 阻塞 队列 上 的 某 个 线程 强制 解除 阻塞 
将 阻塞 队列 上 的 某 个 线程 休 眼 

修改 阻塞 队列 上 的 某 个 线程 的 优先 级 



































属性 成 员 指向 宿主 对 象 的 属性 成 员 。 这 样 在 操作 队列 时 ， 可 以 直接 引用 宿主 对 象 的 各 种 配置 参数 而 不 必 再 去 查找 宿主 地 址 。 




















当 线 程 需要 在 IPC 对 象 上 阻塞 时 ， 首 先 会 把 线程 操作 的 对 象 的 信息 保存 在 线程 结构 中 的 lpcRecord 结 构成 员 中 。 这 是 通过 函数 ulpcSaveRecord () 完成 的 。 


3.3.3 ”清除 线程 阻塞 信息 


线程 读 取 阻塞 操作 的 结果 后 ， 通 过 函数 ulpcCleanRecord () 清理 IpcRecord 记 录 ， 然 后 返回 主 调 函 数 ， 至 此 1PC 操 作 结 束 。 


3.3.4” 读 取 线程 阻塞 结果 





当 阻 塞 状态 的 线程 被 解除 阻塞 后 ， 线 程 从 阻塞 点 继续 执行 ， 首 先 会 通过 函数 读 ulpcReadState () 取 引 起 本 次 阻塞 的 操作 的 结果 ， 操 作 结 果 记 录 在 lpcRecord 记 录 里 。 


3.3.5 ”线程 阻塞 过 程 








线程 通过 阻塞 方式 访问 IPC 对 象 ， 如 果 条 件 不 满足 则 通过 函数 ulpcBlockThread () 将 自己 阻塞 。 主 要 通过 以 下 步骤 来 完成 阻塞 操作 : 


. 保存 本 次 操作 IPC 的 信息 到 IpcRecord 中 。 
“ 将 自己 从 内 核 线程 就 绪 队 列 中 移出 。 
将 自己 加 入 到 IPC 对 和 象 的 线程 阻塞 队列 。 
“ 修改 自己 的 状态 为 阻塞 态 。 


“ 如 果 是 时 限 阻 塞 方式 ， 则 将 启动 自己 的 线程 定时 器 。 


3.3.6 ”解除 线程 阻塞 过 程 


内 核 通过 函数 ulpcUnblockThread () 解除 指定 线程 的 阻塞 。 主 要 通过 以 下 步骤 来 完成 操作 : 


:将 线程 从 IPC 对 象 的 线程 阻塞 队列 中 移出 。 


“ 将 线程 加 入 到 内 核 线程 就 绪 队 列 中 。 


: 修改 线程 的 状态 为 就 绪 态 。 


“ 如 果 是 时 限 阻塞 方式 ， 则 停止 线程 的 私有 定时 器 。 


3.3.7 ”解除 最 佳 线程 阻塞 过 程 





内 核 通 过 函数 ulpcUnblockOptimalThread () 从 IPC 对 象 的 线程 阻塞 队列 中 选择 最 恰当 的 线程 并 解除 它 的 阻塞 。 主 要 通过 以 下 步骤 来 完成 操作 : 
“ 查找 ITPC 阻 塞 队列 中 的 最 佳 线程 ， 辅 助 队列 中 的 线程 优先 考虑 。 


“ 通过 uIpcUnblockThread () 函数 来 完成 最 终 的 阻塞 解除 操作 。 


3.3.8 ”解除 全 部 线程 阻塞 过 程 


内 核 通过 函数 ulpcUnblockAllThreads () 逐一 将 IPC 对 象 的 线程 阻塞 队列 的 线程 解除 阻塞 : 
“ 循环 检查 IPC 对 象 的 线程 阻塞 队列 的 辅助 队列 ， 通 过 uIpcUnblockThread () 函数 将 其 中 的 全 部 线程 逐一 解除 阻塞 。 


“ 循环 检查 IPC 对 象 的 线程 阻塞 队列 的 基本 队列 ， 通 过 uIpcUnblockThread () 函数 将 其 中 的 全 部 线程 逐一 解除 阻塞 。 


3.3.9 ”强制 解除 线程 阻塞 














函数 ulpcAbortThread () 可 以 用 来 强制 解除 某 个 线程 在 IPC 对 象 上 的 阻塞 。 和 以 上 函数 不 同 ， 本 函数 是 一 种 强制 操作 ， 并 没有 按照 IPC 对 象 阻 塞 方案 的 流程 来 处 理 。 函 数 首先 检查 被 解除 阻塞 的 线程 是 
否 阻塞 在 指定 的 IPC 对 象 上 ， 如 果 是 则 通过 函数 ulpcUnblockThread () 来 解除 线程 的 阻塞 。 








3.3.10 ”休眠 被 阻塞 的 线程 


内 核 通 过 函数 ulpcDeActivate () 解除 指定 线程 的 阻塞 ， 然 后 将 线程 休眠 (不 是 置 为 就 绪 ) 。 主 要 有 以 下 步骤 来 完成 操作 : 
: 将 线程 从 IPC 对 象 的 线程 阻塞 队列 中 移出 。 
“ 将 线程 加 入 到 内 核 线程 辅助 队列 中 。 
“ 修改 线程 的 状态 为 休眠 态 。 


“如果 是 时 限 阻塞 方式 ， 则 停止 线程 的 私有 定时 器 。 


3.3.11 ”设置 被 阻塞 线程 的 优先 级 




















函数 ulpcSetThreadPriority () 用 来 改变 处 在 IPC 阻 塞 队列 中 的 线程 的 优先 级 。 
“ 如 果 线 程 所 属 队列 采用 优先 级 策略 ， 则 将 线程 从 所 属 的 资源 阻塞 队列 中 移出 ， 然 后 修改 它 的 优先 级 ， 最 后 再 放 回 原 队 列 。 


“ 如 果 是 先入 先 出 队列 则 直接 修改 线程 优先 级 。 












































以 上 介绍 的 这 些 函 数 是 Trochili RTOS IPC 的 底层 通用 机 制 ， 内 核 通 过 这 些 最 小 功能 的 函数 可 以 支持 各 种 具体 IPC 对 象 的 功能 的 实现 。 随 后 的 章节 将 详细 介绍 如 何 实现 各 种 IPC 机 制 。 


第 4 章 ”信号 量 设计 与 实现 


在 实际 的 多 任务 应 用 中 ， 任 务 间 、 任 务 和 ISR 间 经 常 要 同步 彼此 的 执行 步骤 ， 内 核 大 多 通过 信号 量 这 种 内 核对 象 来 实现 这 个 功能 。 信 号 量 是 一 种 统称 ， 常 见 的 信号 量 主要 有 三 种 : 二 值 信号 量 、 计 数 信 号 


和 互 斥 信号 量 ， 它 们 有 各 自 典型 的 使 用 模式 。 从 使 用 目的 角度 考虑 ， 作 者 更 希望 把 互 斥 信号 量 和 另外 两 种 信号 量 的 概念 区 分 开 来 。 


Trochili RTOS 目 前 支持 二 值 信号 量 、 计 数 信号 量 和 互 斥 信号 量 。 其 中 二 值 信号 量 和 计数 信号 量 是 在 一 起 设计 实现 的 ， 而 互 斥 信号 量 则 是 单独 实现 的 。 在 本 书 的 描述 中 ， 前 两 者 经 常 统称 为 信号 量 ， 而 后 


者 被 称 为 互 斥 量 。 本 章 主 要 介绍 二 值 信号 量 和 计数 信号 量 的 概念 、 设 计 实现 和 典型 的 使 用 模式 。 


4.1 信号 量 的 基本 知识 









































祖 号 量 用 于 同步 的 时 候 就 像 交 通 灯 ， 任 务 只 有 在 获得 许可 的 时 候 才 可 以 运行 ， 强 调 的 是 运行 步骤 ;信号 量 用 于 互 斥 的 时 候 就 像 一 把 钥匙 ， 它 强调 只 有 获得 钥匙 的 任务 才 可 以 运行 ， 强 调 的 是 许可 和 权 
限 。 信 号 量 只 用 于 同步 或 者 互 斥 操作 ， 它 不 具备 任何 数据 交换 的 功能 。 






































4.1.1 二 值 信 号 量 的 概念 












































二 值 信号 量 只 能 取 两 个 值 ， 作 为 资源 是 否 可 用 的 标记 ， 或 者 用 来 同步 任务 。 当 它 被 创建 时 ， 初 始 值 可 以 在 0 或 1 中 任 选 ， 这 是 根据 应 用 的 需要 来 设置 的 。 需 要 注意 的 是 二 值 信 号 量 可 以 被 任何 任务 或 者 |SR 
释放 ， 甚 至 在 它们 从 来 没有 获得 过 二 值 信号 量 的 情况 下 。 


























1. 二 值 信号 量 的 状态 






































二 值 信号 量 通常 拥有 两 种 状态 : 可 用 和 不 可 用 。 根 据 需要 ， 二 值 信号 量 可 以 被 初始 化 成 可 用 或 者 不 可 用 。 以 初始 状态 为 不 可 用 为 例 ， 当 有 任务 释放 信号 量 时 ， 它 的 状态 转 为 可 用 。 当 有 任务 获得 信号 量 
后 ， 它 的 状态 随 之 变 为 不 可 用 。 随 着 任务 对 二 值 信号 量 的 操作 ， 它 的 状态 在 这 2 种 情况 下 相互 转换 ， 符 合 有 限 状 态 机 机 制 。 


































































































当 二 值 信号 量 处 于 不 可 用 的 状态 时 ， 如 果 有 任务 来 获取 ， 那 么 该 任务 直接 返回 失败 ， 或 者 阻塞 到 该 二 值 信号 量 上 ， 直 到 该 二 值 信号 量 可 用 或 者 任务 阻塞 时 限期 满 ， 当 二 值 信号 量 处 于 可 用 状态 时 ， 如 果 
有 任务 来 释放 信号 量 ， 那 么 该 任务 直接 返回 失败 ， 或 者 阻塞 到 该 信号 量 上 。 注 意 1SR 操 作 信 号 量 时 ， 只 能 立刻 返回 操作 结果 ， 这 是 因为 1SR 不 能 被 阻塞 。 















































图 4-1 描 述 了 二 值 信号 量 的 状态 迁移 和 原因 。 











获得 (value = 0) 


初始 化 可 咱 不 可 用 初始 化 


(value=1) (value=0) 


释放 (value=1) 
图 4-1 ”二 值 信号 量 状态 迁移 图 


2. 任务 阻塞 队列 





二 值 信号 量具 有 任务 阻塞 的 能 力 ， 名 义 上 二 值 信号 量 拥有 两 个 不 同类 型 的 任务 阻塞 队列 ， 代 表 了 获取 信号 量 的 任务 阻塞 队列 和 释放 信号 量 的 任务 阻塞 待 队列 。 而 实现 上 只 需要 一 个 任务 阻塞 队列 就 可 以 
了 ， 因 为 不 可 能 同时 阻塞 两 个 这 样 的 任务 : 一 个 不 能 获取 信号 量 而 另 一 个 不 能 释放 信号 量 。 


























需要 注意 的 是 ， 当 二 值 信号 量 为 不 可 用 时 ， 如 果 有 任务 处 于 二 值 信号 量 的 任务 阻塞 队列 中 ， 说 明 当 前 二 值 信号 量 的 任务 阻塞 队列 是 信号 量 获 取 任 务 队列 。 如 果 此 时 有 任务 释放 二 值 信号 量 ， 可 以 直接 从 
二 值 信号 量 的 任务 阻塞 队列 中 找到 一 个 合适 的 任务 ， 并 直接 使 它 获取 信号 量 成 功 ， 同 时 二 值 信号 量 的 状态 不 变 。 同 理 ， 在 二 值 信 号 量 可 用 时 ， 如 果 有 任务 处 于 二 值 信 号 量 的 任务 阻塞 队列 ， 说 明 当前 二 值 信 
号 量 的 任务 阻塞 队列 是 信号 量 释 放任 务 队列 ， 假 如 此 时 有 任务 来 获取 信号 量 ， 可 以 从 二 值 信号 量 的 任务 阻塞 队列 中 找到 一 个 合适 的 任务 ， 并 直接 使 它 释放 信号 量 成 功 。 此 时 二 值 信号 量 状态 同样 保持 不 变 。 












































4.1.2 计数 信号 量 的 概念 





























计数 信号 量 通常 用 来 表示 资源 可 用 的 个 数 。 它 提供 一 个 计数 器 给 任务 或 者 SR 来 使 用 ， 计 数 器 的 数值 代表 了 还 有 多 少 个 资源 可 以 使 用 ， 数 值 0 说 明 没有 资源 可 供 使 用 。 任 务 或 者 |SR 可 以 多 次 获取 一 个 计数 
信号 量 ， 直 到 它 的 计数 减 小 到 0 为 止 。 和 二 值 信号 量 一 样 ， 计 数 信号 量 可 以 被 任何 任务 或 者 ISR 释 放 ， 哪 怕 它 们 从 来 没有 获得 过 该 计数 信号 量 。 















































1. 计数 信号 量 状态 








计数 信号 量 通常 可 以 按照 计数 的 多 少 来 区 分 其 状态 。 根 据 需 要 ， 计 数 信 号 量 可 以 被 初始 化 为 任何 状态 。 以 计数 初始 化 为 0 为 例 ， 此 时 它 处 于 不 可 获取 、 可 以 释放 的 状态 ， 当 有 任务 释放 信号 量 时 ， 它 转 为 
1， 即 可 以 获取 、 可 以 释放 的 状态 ， 当 任务 继续 释放 信号 量 ， 当 计数 达到 最 大 时 ， 它 的 状态 为 不 可 释放 、 可 以 获得 的 状态 。 随 着 计数 信号 量 的 获取 和 释放 ， 计 数 信 号 量 的 状态 在 这 3 种 情况 下 相互 转换 ， 符 合 
有 限 状 态 机 机 制 。 图 4-2 描 述 了 计数 信号 量 的 状态 迁移 和 原因 : 




















获取 获取 获取 
value—— value—— Value 一 一 
(value == Max-1 ) (0 < value 二 Max) (value ==0) 






初始 化 


(value == Max) 


初始 化 


(value == 0 ) 







可 获取 
不 可 释放 





释放 释放 释放 
Value ++ value++ Value+ 十 
(value == Max) (0 二 value 二 Max) (value ==1) 


图 4-2 ”计数 信号 量 状态 迁移 图 


2. 任务 阻塞 队列 








计数 信号 量具 有 任务 阻塞 的 能 力 ， 名 义 上 计数 信号 量 拥有 两 个 不 同类 型 的 任务 阻塞 队列 ， 代 表 了 获取 信号 量 的 任务 阻塞 队列 和 释放 信号 量 的 任务 阻塞 队列 。 而 实现 上 只 需要 一 个 任务 阻塞 队列 就 可 以 
因为 不 可 能 同时 阻塞 两 个 这 样 的 任务 : 一 个 不 能 获取 信号 量 而 另 一 个 不 能 释放 信号 量 。 
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需要 注意 的 是 ， 当 计数 信号 量 为 不 可 获取 时 ， 即 计数 为 0 时 ， 如 果 有 任务 处 于 计数 信号 量 的 任务 阻塞 队列 中 ， 说 明 当 前 计数 信号 量 的 任务 阻塞 队列 是 信号 量 获取 任务 队列 。 如 果 此 时 有 任务 释放 计数 信号 
量 ， 可 以 直接 从 计数 信号 量 的 任务 阻塞 队列 中 找到 一 个 合适 的 任务 ， 并 直接 使 得 它 成 功 获取 信号 量 ， 同 时 计数 信号 量 的 状态 不 变 ; 同 理 ， 在 计数 信号 量 可 获取 、 不 可 释放 时 ， 即 计数 达到 最 大 时 ， 如 果 有 任 


务 处 于 计数 信号 量 的 任务 阻塞 队列 ， 说 明 当 前 计数 信号 量 的 任务 阻塞 队列 是 信号 量 释 放任 务 队列 ， 假 如 此 时 有 任务 来 获取 信号 量 ， 可 以 从 计数 信号 量 的 任务 阻塞 队列 中 找到 一 个 合适 的 任务 ， 并 直接 使 得 它 
成 功 释放 信号 量 。 此 时 计数 信号 量 状态 同样 保持 不 变 ; 当 计 数 信号 量 的 计数 处 于 0 和 最 大 值 之 间 时 ， 此 时 计数 信号 量 可 以 被 获取 也 可 以 被 释放 ， 其 任务 阻塞 队列 中 不 会 有 任务 被 阻塞 。 


百 写 星 : 












































4.1.3 ”信和 号 量 的 操作 


常见 信号 量 的 操作 见 表 4-1。 


功能 功能 功 操作 功能 


2 信号 量 删除 信号 量 任务 阻塞 队列 的 刷新 


了 
3 信号 量 获取 信号 量 状态 查询 


(1) Create 信 号 量 创建 





构 可 以 被 系统 分 配 或 者 初始 化 ， 在 创建 信号 量 时 ， 用 户 可 以 指定 信号 量 的 各 种 参数 属性 。 比 如 针对 多 个 任务 在 信号 量 上 的 阻塞 和 调度 方式 ， 既 可 以 配置 成 FIFO 方 式 来 处 理 ， 也 可 以 按照 任务 优 


信和 号 量 结 


(2) Delete 信 号 量 删除 
删除 信号 量 时 ， 需 要 把 所 有 阻塞 在 信号 量 上 的 任务 解除 阻塞 ， 信 和 号 量 一 但 被 删除 ， 就 不 能 再 次 使 用 了 。 

(3) Obtain 信 号 量 获取 

成 功 获取 信号 量 的 时 候 会 导致 信号 量 计数 减 1。 如 果 信 号 量 不 能 被 获取 ， 则 当前 任务 或 者 直接 返回 ， 或 者 阻塞 在 信号 量 的 任务 阻塞 队列 中 。 如 果 是 ISR 执 行 该 功能 失败 ， 则 应 该 直接 返回 而 不 能 被 阻塞 。 
(4) Release 信 号 量 释 放 
成 功 释放 信和 号 量 的 时 候 会 导致 信号 量 计数 加 1。 如 果 信 号 量 不 能 被 释放 ， 则 当前 任务 或 者 直接 返回 ， 或 者 阻塞 在 信号 量 的 任务 阻塞 队列 中 。 如 果 是 ISR 执 行 该 功能 失败 ， 则 应 该 直接 返回 而 不 能 被 阻塞 。 


(5) Flush 信 号 量 任务 阻塞 队列 的 刷新 








当 有 多 个 任务 因为 不 能 获取 或 者 释放 信号 量 而 阻塞 在 信号 量 的 任务 阻塞 队列 时 ， 可 以 通过 Flush 操 作 将 这 些 任 务 解除 阻塞 ， 完 成 多 任务 的 同步 。 


(6) Query 信 和 号 量 状态 查询 


应 用 程序 可 以 随时 查看 菜 个 信号 量 的 当前 状态 ， 将 信号 量 的 数据 结构 复制 后 分 析 。 但 需要 注意 因为 复制 出 来 的 数据 只 是 系统 菜 个 时 刻 的 情况 ， 所 以 需要 用 户 革 酌 使 用 。 


4.1.4 信号 量 的 应 用 









































在 实际 运行 的 系统 中 ， 在 任务 和 任务 之 间或 者 任务 和 1ISR 之 间 ， 总 是 有 各 种 同步 的 需求 或 者 对 资源 的 共享 访问 ， 通 过 信号 量 能 够 简洁 地 实现 这 些 功能 。 下 面 介绍 几 种 信号 量 的 典型 用 法 。 


1. 任务 单 向 同步 








4-3 所 
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在 这 种 模式 下 ， 一 个 任务 用 来 获取 信号 量 ， 另 外 一 个 任务 或 者 1SR 释 放 信 号 量 。 获 取信 号 量 过程 和 释放 信号 量 过 程 没有 过 多 联系 ， 释 放 信号 量 的 任务 或 SR 不 必 了 解 获取 信号 量 的 任务 的 情况 ， 如 


Releas Ob 
入 让 信号 是 的 任务 或 者 TSR -> 一 > 




















示 。 


图 4-3 ”二 值 信号 量 用 于 任务 单 向 同步 








图 4-3 演 示 了 两 个 任务 通过 一 个 二 值 信号 量 进行 同步 的 情景 。 在 这 种 模式 下 ， 系 统 的 行为 和 两 个 任务 的 优先 级 是 密切 相关 的 (ISR 的 优先 级 必然 高 于 任务 的 优先 级 ) 。 假 设 信号 量 初始 时 计数 为 0， 两 个 任 
务 分 别 不 停 地 获取 和 释放 信号 量 。 我 们 来 分 析 这 个 模式 下 的 具体 任务 间 的 协作 情况 : 

















假如 释放 信号 量 任务 的 优先 级 低 于 获取 信号 量 任务 的 优先 级 ， 那 么 获取 信号 量 任务 首先 执行 。 因 为 信号 量 开始 时 计数 为 0， 所 以 信号 量 获取 任务 立刻 阻塞 在 信号 量 的 任务 阻塞 队列 上 。 随 后 信号 量 释放 任 
务 得 到 处 理 器 ， 释 放 信 号 量 。 因 为 优先 级 抢占 的 原因 ， 获 取信 号 量 任务 立刻 执行 并 取得 信号 量 。 之 后 ， 如 果 它 希望 再 次 获取 信号 量 ， 那 么 因为 信号 量 计数 又 变 成 0， 所 以 信号 量 获取 任务 会 再 次 阻塞 。 而 此 后 


信号 量 释 放任 务 将 再 次 运行 。 

































































Release 


释放 信号 量 的 任务 或 者 ISR 上 |-------- > 





计数 信 


图 4-4 ”计数 信号 量 用 于 任务 单 向 同步 
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Obtaln 


三 内 
里: 








图 4-3 采 用 的 是 二 值 信号 量 ， 如 果 是 计数 信号 量 ， 我 们 再 分 析 一 下 它 的 运行 情况 。 我 们 假设 信号 量 发 送 任务 一 直 释 放 信 号 量 ， 而 信号 量 获取 任务 则 一 直 获 取信 号 量 ， 如 图 4-4 所 示 。 














获取 信号 量 的 任务 

















假如 信号 量 释放 任务 的 优先 级 高 于 信号 量 获取 任务 的 优先 级 ， 那 么 信号 量 释 放任 务 会 一 直 释 放 信 号 量 ， 直 














到 信号 量 计数 达到 最 大 ， 信 号 量 释放 任务 才 会 停止 操作 ， 然 后 阻塞 在 信号 量 的 任务 阻塞 队列 


上 ; 之 后 信号 量 获取 任务 才 会 得 以 运行 并 成 功 得 到 信号 量 ， 但 这 个 操作 导致 信号 量 释放 任务 立刻 被 唤醒 并 抢占 处 理 器 ， 同 时 完成 对 信号 量 的 释放 操作 ， 信 号 量 计数 依然 保持 最 大 。 等 信号 量 释 放任 务 又 一 次 


尝试 释放 信号 量 时 ， 它 会 再 次 阻塞 ， 之 后 信号 量 获取 任务 再 次 运行 。 在 这 个 模型 中 ， 计 数 信 号 量 可 以 累积 缓冲 多 次 



































ISR 典 型 地 使 用 上 面 的 方式 ， 因 为 ISR 是 要 抢占 任何 任务 来 执行 的 。 另 外 ，ISR 必 须 使 用 非 阻塞 方式 来 释放 信号 量 ， 如 果 释 放 操作 不 能 成 功 则 丢失 |SR 





























这 种 模式 的 伪 代 码 如 代码 清单 4-1 所 示 。 


代码 清单 4-1: 信号 量 同步 演示 


事件 。 





件 。 





村 void TaskSender (void) 

i 

3。 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 
4. Release Semaphore 

5。 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OFBPSVText/ . 
6. } 

a 

8. void TaskReceiver (void) 

9. 

10 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 
了 Obtain Semaphore 

12。 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 
13 : 


.http://www.hzcourse.com/resource/readBook?path=/openresour 


.http://www.hzcourse.com/resource/readBook?path=/openresour 


.http://www.hzcourse.com/resource/readBook?path=/openresour 


.http://www.hzcourse.com/resource/readBook?path=/openresour 





2. 任务 双向 同步 





有 时 候 ， 两 个 任务 间 需 要 互相 同步 ， 一 个 任务 只 有 得 到 另 一 个 任务 的 确认 后 才 可 以 继续 执行 。 该 模型 如 
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( 4 ) ReleaseB 


图 4-5 ”二 值 信号 量 用 于 任务 双向 同步 











4-5 所 示 。 


在 图 4-5 所 示 的 模型 中 ， 包 括 两 个 二 值 信 号 量 和 两 个 任务 。 初 始 时 信号 量 计 数 都 为 0。 我 们 假设 任务 A 和 任务 B 优 先 级 相同 ， 并 且 不 会 因为 时 间 片 切换 。 





这 个 模型 的 运行 情况 如 下 : 


“ 任务 A 首先 运行 ， 它 首先 尝试 获得 信号 量 A， 作 为 自己 下 一 步 运 行 的 许可 。 因 为 这 时 信号 量 A 计 数 为 0， 所 以 任务 A 阻塞 在 信号 量 A 的 任务 阻塞 队列 上 。 


“ 然后 任务 B 得 到 运行 ， 任 务 B 处 理 完 后 ， 释 放 信 号 量 A， 间 接 唤醒 任务 A。 

“ 随后 任务 B 尝 试 获取 信号 量 B， 因 为 此 时 信号 量 B 的 计数 为 0， 所 以 任务 B 会 阻塞 。 
“ 任务 A 再 次 运行 ， 任 务 A 完成 后 会 释放 信号 量 B， 间 接 唤醒 任务 B。 

“ 任务 A 再 次 运行 ， 它 再 次 尝试 获得 信号 量 A， 并 且 会 被 阻塞 。 


“ 任务 B 再 次 运行 ， 任 务 B 处 理 完 后 ， 它 会 再 次 释放 信号 量 A， 并 且 因 为 获取 信号 量 B 而 被 阻塞 。 





这 种 模式 的 伪 代 码 如 代码 清和 


4-2 所 示 。 





代码 清单 4-2: 信号 量 双向 同步 演示 





On WwW ID 上 


SemaphoreB 


3. 多 任务 单 向 同步 


void TaskA (void) 


{ 


Obtain SemaphoreA; 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 


} 


void TaskB (void) 


Release 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 
Release Semaphorea; 
Obatin SemaphoreB 


在 多 任务 系统 中 ， 多 个 任务 可 能 需 





要 等 待 相同 的 村 


任务 或 者 ISR 








网 


如 











4-6 所 示 ， 二 值 信号 量 初始 值 为 0， 有 多 个 任务 都 
塞 。 这 是 一 种 多 任务 同步 的 模型 。 


信号 量 FLUSH 操 作 的 模型 代码 如 代码 清单 4-3 所 示 。 


代码 清单 4-3: 信号 量 多 任务 同步 


Ls 
void TaskObatin (void) 
蔡 5 
3 http://www.hzcourse. 
4. Obtain Semaphore; 
5 http://www.hzcourse. 
6. } 
间 二 
号 。 void TaskFlush (void) 
9. { 
1 http://www.hzcourse. 
1s Flush Semaphore; 
12, http://www.hzcourse. 
13。 } 
4. 共享 资源 的 同步 访问 
对 共享 


该 应 


资源 的 互 斥 访问 是 二 值 信号 量 的 一 个 很 重 
放 信号 量 。 代 表 资源 许可 权限 的 二 值 信号 量 初始 时 计数 必须 是 1， 即 代表 可 














模型 如 











图 4-7 所 示 。 








Flush 








件 发 生 后 才能 继续 运行 ， 这 时 使 

















图 4-6 








二 值 人 








计 号 量 用 于 多 任务 同步 


信和 号 量 的 FLUSH 机 制 就 可 以 满足 需求 ， 如 图 4-6 所 示 。 











任务 1 


Obtian 


任务 2 
Obtaln 


Obtain 


I 


Obtain 


任务 n 


为 获取 信号 量 而 被 阻塞 在 信号 量 的 任务 阻塞 队列 上 。 当 有 任务 或 者 1SR 对 信号 量 进行 FLUSH 操 作 时 ， 所 有 阻塞 在 信号 量 上 的 任务 会 被 同时 解除 阻 




















的 








它 能 实现 多 个 任务 对 共享 资源 的 访问 串 行 化 ， 避 免 资源 使 



































com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/O0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 


com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 


com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/O0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 


com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 

















混乱 。 任 务 只 有 在 获得 信号 量 的 前 提 下 才能 使 用 资源 ， 并 且 需 要 在 使 用 资源 后 释 
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图 4-7 “二 值 信号 量 用 于 共享 资源 保护 

















在 图 4-7 中 ， 三 个 任务 都 需要 访问 某 个 共享 资源 ， 并 且 在 任务 和 资源 之 间 加 入 信号 量 进行 访问 保护 ， 有 效 避 免 多 任务 访问 资源 的 冲突 。 





这 个 模式 有 个 问题 就 是 二 值 信号 量 可 以 被 任何 其 他 任务 或 者 SR 释放， 假如 任务 A 得 到 信号 量 之 后 正在 访问 资源 ， 结 果 某 个 任务 不 经 意 释 放 了 信号 量 ， 那 么 任务 B 或 者 任务 C 都 可 能 成 功 得 到 信号 量 并 访问 
资源 。 解 决 这 个 问题 的 办 法 是 采用 互 斥 量 ， 因 为 互 斥 量 支持 所 有 者 的 概念 ， 非 互 斥 量 所 有 者 不 能 释放 互 斥 量 。 互 斥 量 的 具体 细节 在 第 5 章 将 会 介绍 。 


/| 









































二 值 信号 量 用 于 共享 资源 保护 的 代码 如 代码 清单 4-4 所 示 : 





代码 清单 4-4: 信号 量 用 于 资源 保护 


14. void TaskAccessResource (void) 

3s { 

16; http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 
17s Obtain Semaphore; 

18. http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 
9 Use Resource; 

20. http://www.hzcourse.cor/resource/readBook?path=/copenresources/teach_ebook/uncompresseq/14878/OEBPSVText/. .http://www.hzcourse.com/resource/readBook?path=/openresoui 
21。 Relese Semaphore; 

22。 } 

23。 





4.2 ”信号 量 设计 实现 











Trochili RTOS 支 持 二 值 信号 量 、 计 数 信号 量 和 互 斥 信号 量 。 在 前 面 已 经 介绍 过 ， 二 值 信号 量 和 计数 信号 量 是 在 一 起 设计 实现 的 ， 信 号 量 控制 结构 定义 在 semaphore.h 文 件 中 ， 其 结构 如 代码 清单 4-5 所 


示 。 








代码 清单 4-5: 信号 量 结构 定义 





Ea 
ji 二 值 信号 量 结构 定义 */ 
struct SemaphoreDef 
3 


4. TProperty Property; Fi 
队列 中 线程 的 光度 第 略 千 属 性 重 革 wy 
Bs pcQueue Queue; /* 
人 量 的 线程 中 机 
TWord Valuey Ea 

- 数 信号 量 的 数值 yy 

TWord MaxValue; Vv 
村 号 量 的 数值 */ 

- ks 

9 typedef struct SemaphoreDef TSemaphore; 





“ Property: 信号 量 支 持 不 同 的 线程 调度 策略 ， 由 该 结构 的 成 员 Property 决 定 。 信 号 量 支持 两 种 线程 排队 的 方式 : FIFO 排 队 方式 和 基于 线程 优先 级 的 排队 方式 。 


“ Value、MaxVaule: 在 信号 量 结 构 中 设计 了 信号 量 的 当前 值 和 最 大 值 这 两 个 成 员 。 在 实现 时 默认 信号 量 最 小 值 为 0， 所 以 当初 始 化 菜 个 信号 量 结 构 时 ， 如 果 把 最 大 值 设 为 大 于 1， 那 么 该 结构 代表 一 个 计 
数 信号 量 ; 而 如 果 把 最 大 值 设置 为 1， 则 该 结构 退化 为 二 值 信 号 量 。 


“Queue: 信号 量 拥有 一 个 线程 阻塞 队列 ， 用 于 保存 那些 因 无 法 获得 信号 量 或 者 无 法 释放 信和 号 量 而 需要 被 阻塞 的 线程 。 这 里 只 需要 设计 一 个 队列 的 原因 是 不 可 能 同时 存在 这 样 的 两 个 任务 ; 一 个 不 能 获取 
信号 量 ， 而 另 一 个 不 能 释放 信号 量 。 前 面 我 们 介绍 过 IPC 的 线程 阻塞 队列 ， 其 中 有 两 个 分 队列 ， 即 基本 队列 和 辅助 队列 。 因 为 信号 量 没 有 特殊 的 功能 ， 所 以 没有 使 用 到 辅助 队列 。 





























线程 和 ISR 都 可 以 来 访问 信号 量 。 线 程 访问 信号 量 时 ， 根 据 访问 模式 ， 当 操作 失败 时 ， 线 程 可 以 选择 直接 返回 、 无 限期 ， 或 者 有 时 限 地 阻塞 在 信号 量 的 线程 阻塞 队列 上 。 当 线程 阻塞 后 ， 其 他 线程 或 者 
1SR 可 以 强制 该 线程 解除 阻塞 。 而 |SR 必 须 采用 立刻 返回 的 方式 来 访问 信号 



































注意 信号 量 状态 的 变化 ， 即 0 计数 、 最 大 计数 和 中 间 计 数 。 当 计数 等 于 0 时 ， 有 可 能 存在 因 获取 信和 号 量 失 败 而 被 阻塞 的 线程 ;计数 等 于 最 大 值 时 ， 则 有 可 能 存在 因 释放 信和 号 量 失 败 而 被 阻塞 的 线程 。 计 数 
值 为 中 间 数 值 时 ， 不 会 存在 任何 被 阻塞 的 线程 。 





当前 Trochili RTOS 实 现 的 信号 量 操作 函数 主要 有 以 下 几 种 : 





“ 信号 量 初始 化 (Init) : Trochili RTOS 提 供 的 API 不 支持 动态 创建 和 删除 信号 量 ， 需 要 用 户 提前 准备 一 个 信号 量 结构 ， 然 后 作为 参数 被 API 初 始 化 。 


“ 信号 量 取 消 初始 化 (Deinit) : 将 信号 量 恢复 到 初始 状态 。 一 个 信号 量 取 消 初 始 化 之 后 ， 如 果 还 想 使 用 它 ， 则 需要 再 次 初始 化 。 
“ 信号 量 刷 新 (Flush) : 将 信号 量 上 的 所 有 阻塞 线程 唤醒 。 它 和 信和 号 量 取消 初始 化 的 区 别 是 ， 信 号 量 刷新 后 ， 保 持 信号 量 最 大 值 和 计数 不 变 ， 仍 处 于 可 用 状态 。 


“ 信和 号 量 释放 (Release) : 尝试 将 已 经 初始 化 的 信和 号 量 的 计数 加 1。 如 果 信号 量 计数 已 经 达到 最 大 值 ， 则 操作 失败 。 根 据 操作 模式 ， 线 程 或 者 直接 退出 或 者 阻塞 在 信和 号 量 的 线程 阻塞 队列 上 。ISR 释 放 信 
号 量 时 即使 失败 也 不 会 被 阻塞 。 


“ 信号 量 获取 (Obtain) : 尝试 将 已 经 初始 化 的 信号 量 的 计数 减 1。 如 果 信号 量 计数 已 经 达到 0 则 操作 失败 ， 根 据 操作 模式 ， 线 程 直 接 退 出 或 者 阻塞 在 信号 量 的 线程 阻塞 队列 上 。ISR 获 取信 号 量 时 即使 失 
败 也 不 会 被 阻塞 ， 但 从 使 用 习惯 上 来 说 ， 不 建议 用 户 在 ISR 中 调用 这 个 函数 。 


“ 线程 阻塞 终止 (Abort) : 将 阻塞 在 信号 量 线程 阻塞 队列 上 的 线程 解除 阻塞 。 


全 


“ 信号 量 查询 (Query) : 将 信号 量 结构 的 数据 完整 的 复制 到 指定 的 结构 中 ， 保 存 信号 量 数据 的 快照 。 注 意 因 为 系统 运行 时 信号 量 随时 可 能 被 操作 ， 所 以 查询 出 来 的 数据 可 能 不 是 最 新 的 ， 需 要 用 户 注 


对 信号 量 操作 函数 的 总 结 见 表 4-2。 


表 4-2 ”信号 量 功能 列表 


0 线程 调用 。 | 。 1SR 调用 


1 TclInitSemaphore 写 量 初 始 化 支持 文 持 





4 文 持 
支持 
6 支持 
7 支持 





4.2.1 信号 量 的 初始 化 

















调用 信号 量 初 始 化 函数 时 可 以 给 信号 量 赋 一 个 初始 值 。 初 始 值 并 不 一 定 是 0 或 者 最 大 值 ， 而 是 根据 实际 需要 来 确定 。 该 函数 的 主要 步骤 是 : 





“ 设置 信号 量 属性 
“ 设置 信号 量 计数 当前 值 
“ 设置 信号 量 计数 最 大 值 


“ 初始 化 信号 量 线程 阻塞 队列 


4.2.2 ”信号 量 的 取消 初始 化 






































前 面 介绍 过 ， 当 前 版 本 的 内 核 不 支持 动态 删除 信号 量 。 内 核 提 供 了 信号 量 取消 初始 化 操作 来 完成 类 似 的 功能 。 如 果 信 号 量 结构 是 用 户 自己 分 配 ， 那 么 用 户 执行 信号 量 取消 初始 化 操作 之 后 ， 还 需要 用 户 
自行 处 理 信号 量 结构 。 信 号 量 取 消 初始 化 操作 和 信号 量 初始 化 操作 是 相反 的 操作 ， 它 会 对 信号 量 进 行 如 下 操作 : 





























“ 重新 设置 成 非 初 始 化 


“ 清空 信号 量 的 线程 阻塞 队列 


“ 把 信号 量 初始 值 归 0 


把 信号 量 最 大 值 归 0 


“ 如 果 必 要 还 会 进行 线程 调度 





该 函数 的 流程 图 如 














4-8 所 示 。 
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图 4-8 信号 量 取消 初始 化 流程 图 











流程 图 分 析 : 

STEP2 内核 进入 独占 区 。 

STEP3 首先 将 信号 量 的 线程 阻塞 队列 清空 ， 唤 醒 全 部 被 阻塞 的 线程 。 

STEP4 取消 初始 化 信号 量 的 计数 ， 最 大 值 为 0; 取消 信号 量 的 就 绪 属 性 。 

STEP5 检查 在 清空 信号 量 的 线程 阻塞 队列 时 是 否 唤醒 了 比 当前 线程 优先 级 高 的 线程 。 

STEP6 如 果 是 ， 则 判断 内 核 是 不 是 允许 线程 调度 。 

STEP7 如 果 是 ， 则 淹 断 该 函数 是 否 被 线程 调用 。 

STEP8 向 内 核发 出 线程 调度 请 求 。 

STEP9 内核 退 出 独占 区 ， 如 果 函 数 运 行 在 线程 环境 下 ， 退 出 后 可 能 发 生 线 程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP10 退出 函数 。 


4.2.3 ”信号 量 的 获取 


信号 量 的 获取 操作 主要 是 由 以 下 几 个 函数 来 完成 的 。 


“ 信号 量 获取 操作 接口 函数 xSemaphore Obtain () : 该 函数 是 信号 量 模块 向 外 提供 的 接口 函数 ， 被 内 核 API 函 数 调 用 。 它 根据 操作 模式 这 个 参数 来 区 分 处 理 本 次 信号 量 的 操作 请 求 。 根 据 操作 模式 的 不 
同 ， 操 作 可 以 分 为 线程 模式 和 ISR 模 式 ， 还 可 以 进一步 细 分 为 线程 阻塞 方式 (无 限期 和 时 限 ) 、 线 程 立刻 返回 和 ISR 立 刻 返 回 3 种 模式 。 另 外 由 该 函数 完成 和 信号 量 相关 的 内 核 数 据 的 保护 工作 。 


“ 线程 获取 信号 量 函 数 ObtainSemaphore () : 该 函数 实现 了 线程 访问 信号 量 的 核心 逻辑 。 它 首先 会 通过 函数 TryObtainSemaphore () 尝试 获取 信号 量 ， 然 后 根据 结果 来 继续 操作 。 后 继 操 作 包括 成 功 后 的 
线程 调度 检查 和 失败 后 的 线程 阻塞 操作 都 是 在 这 里 完成 。 


' ISR 获 取信 号 量 函 数 IsrObtainSemaphore () : 该 函数 比较 简单 。 因 为 在 用 户 ISR 里 不 会 有 线程 调度 的 问题 (线程 调度 的 逻辑 在 ISR 返 回 时 由 内 核 处 理 ) 。 它 同 线程 获取 信号 量 函 数 一 样 ， 同 样 是 调用 尝试 


获取 信号 量 函数 TryObtainSemaphore () 。 
“ 尝试 获取 信号 量 函 数 TryObtainSemaphore () : 这 个 函数 是 获取 信号 量 的 核心 部 分 ， 它 会 根据 信号 量 计数 来 处 理 本 次 请 求 。 
“ 如 果 信号 量 计数 已 经 为 0， 则 直接 返回 失败 。 


“ 如 果 信号 量 计数 为 最 大 值 ， 则 需要 检查 该 信号 量 的 线程 阻塞 队列 是 否 有 线程 存在 ; 如 果 有 ， 则 说 明 此 时 阻塞 的 线程 ， 都 是 因为 信号 量 达 到 最 大 值 而 不 能 释放 信号 量 的 线程 ， 所 以 本 次 信号 量 操 作 不 
会 对 信号 量 计数 有 任何 影响 ， 只 需要 在 全 部 阻塞 线程 中 找到 一 个 合适 的 线程 并 将 其 唤醒 就 可 以 了 ; 如 果 没 有 ， 则 需要 将 信号 量 计 数 减 1。 


“ 如 果 信和 号 量 计数 是 中 间 值 ， 则 需要 将 信号 量 计数 减 1。 





这 几 个 函数 的 层次 关系 比较 简单 。 注 意 xSemaphoreObtain () 起 到 的 是 分 发 调用 的 作用 ， 函 数 ObtainSemaphore () 和 IsrObtainSemaphore () 是 不 同 运 行 环境 下 的 具体 操作 函数 ， 而 














TryObtainSemaphore () 则 主要 是 操作 信号 量 对 象 。 这 几 个 函数 的 流程 如 图 4-9 至 图 4-11 所 示 。 函 数 IsrObtainSemaphore () 的 实现 很 简单 ， 就 不 再 详细 分 析 了 。 








1. 信号 量 获取 接口 函数 





言 号 量 获 取 接 口 函数 的 流程 图 如 图 4-9 所 示 。 






























2 内 核 进入 独占 区 





3 ISR 来 获取 信号 量 ? 












4ISR 获取 信号 量 5 线程 获取 信号 量 








图 4-9 ”信号 量 获取 接口 函数 流程 














流程 图 分 析 : 











STEP2 内 核 进入 独占 区 。 


STEP3 判断 是 不 是 ISR 来 获取 信号 量 。 


STEP4 ”如果 是 则 调用 ISR 获 取信 号 量 函 数 。 


STEP5 如 果 不 是 则 调用 线程 获取 信号 量 函 数 。 


STEP6 ”内核 退出 独占 区 。 


STEP7 函数 返回 。 




















从 上 面 的 流程 图 中 可 以 看 出 ， 这 个 函数 是 接口 函数 ， 逻 辑 简单 ， 只 须根 据 操 作 类 型 判断 下 一 步 该 怎么 执行 。 但 是 从 整个 系统 的 层次 划分 来 考虑 ， 模 块 向 外 提供 这 样 一 种 封装 起 来 的 功能 接口 函数 却 是 很 
必要 的 。 


2 线程 获取 信号 量 函 数 











线程 获取 信号 量 函 数 的 流程 图 如 图 4-10 所 示 。 




















流程 图 分 析 : 








STEP2 当前 线程 尝试 获取 信号 量 。 


STEP3 判断 本 次 获取 信号 量 操作 是 否 成 功 。 


STEP4 如 果 没 有 成 功 ， 则 需要 检查 本 次 操作 是 不 是 阻塞 模式 。 


STEP5 如 果 是 ， 则 判断 内 核 是 不 是 关闭 了 线程 调度 。 


STEP6 如 果 没有 ， 此 时 需要 保存 本 次 操作 的 信息 到 线程 相关 结构 ， 并 将 自己 阻塞 在 信号 量 的 线程 阻塞 队列 。 

STEP7 向 内 核发 出 线程 调度 请 求 。 

STEP8 ”内核 退出 独占 区 ， 因 为 是 在 线程 环境 下 ， 退 出 后 极 有 可 能 发 生 线程 调度 ， 除 非 此 时 有 ISR 及 时 发 生 并 且 释 放 了 该 信号 量 ; 如 果 发 生 了 调度 ， 则 当前 线程 被 阻塞 ， 直 到 被 再 次 唤醒 。 
STEP9 线程 被 唤醒 并 且 再 次 调度 执行 ， 在 这 里 立刻 使 内 核 进入 独占 区 。 

STEP10 读 取 本 次 信号 量 获取 操作 的 结果 ， 随 后 清空 当前 线程 的 IPC 缓 存 信 息 。 

STEP11 如 果 在 STEP4 成 功 获得 信号 量 ， 则 需要 检查 在 获得 信和 号 量 的 时 候 是 不 是 唤醒 了 比 当前 线程 优先 级 更 高 的 线程 ， 如 果 没有 ， 则 退出 函数 。 

STEP12 如 果 有 ， 则 需要 检查 内 核 此 时 是 不 是 关闭 了 线程 调度 。 

STEP13 如果 没有 ， 则 向 内 核发 出 线程 调度 请 求 。 


STEP14 函数 返回 。 








从 上 面 的 流程 中 可 以 看 出 ， 在 线程 进行 信号 量 的 获取 时 ， 首 先是 通过 函数 TryObtain Semaphore () 尝试 操作 信号 量 ， 在 尝试 的 过 程 中 可 能 成 功 也 可 能 失败 (在 成 功 的 时 候 ， 有 可 能 唤醒 了 阻塞 在 信号 
量 上 的 某 个 线程 ， 并 且 这 个 被 唤醒 的 线程 的 优先 级 可 能 比 当前 线程 更 高 ) ， 然 后 再 根据 尝试 的 结果 进行 以 下 操作 : 失败 了 可 能 需要 把 自己 阻塞 ; 成 功 了 有 可 能 需要 进行 线程 调度 。 代 码 清单 4-6 所 示 。 



































否 


8 内 核 退 出 独占 区 | 


线程 阻塞 阶段 





9 内 核 进入 独 上 区 





代码 清单 4-6: 线程 获取 信号 量 代码 演示 


图 4-10 ”线程 获取 信号 量 函 数 流程 图 





本 

获取 信号 量 

2 { 

六 

尝试 获得 信号 量 

上 if 

成 功 得 到 信号 量 ) 

二 { 

6. a 
有 更 高 优先 级 线程 被 唤醒 
内 核 没有 关闭 线程 调度 ) 
好 { 

2. 

向 认 信 和 请 线 调度 


10. } 
Ls else 


13. 这 丰 让 
引力 台 次 取 位 号 量 
内 核 没 有 关闭 线程 调度 ) 


当前 线程 阻塞 在 该 信号 量 的 阻塞 队列 ， 
申请 线程 调度 ; 








基 计 此 处 非常 有 可 能 发 生生 次 调度 ， 除 非 线程 测度 请 求 被 内 核 取消 ; 
当 交 理 器 再 次 处 理 本 线程 时 ， 从 本 处 继续 运行 。 */ 

得 次 关闭 系统 中 有， 

奖 和 对 信 号 过 生 作 的 结果 ; 


清除 线程 IPC 
阻塞 信息 ; 








3. 尝试 获取 信号 量 函 数 


尝试 获取 信号 量 函 数 的 流程 图 如 图 4-11 所 示 。 





5 线程 唤醒 成 功 ? 





流程 图 分 析 : 
STEP2 
STEP3 检查 信号 量 当前 计数 是 不 是 最 大 值 。 
STEP4 如 果 信和 号 
STEP5 判断 是 不 是 真 的 唤醒 了 一 个 线程 。 


STEP6 如 果 不 是 ， 则 将 信号 量 计数 减 1。 


STEP7 函数 返回 。 


从 上 面 的 流程 可 以 看 出 ， 在 尝试 进 
在 阻塞 的 线程 ， 








代码 清单 4-7: 尝试 获得 信号 量 演示 代码 


检查 信号 量 当前 计数 是 不 是 为 0， 如 果 是 ， 则 返 


量 计数 是 最 大 值 ， 则 尝试 从 信号 


行 信号 量 获取 时 ， 是 不 区 分 被 线程 调 
号 里 计数 不 多 不 少时 ， 则 直接 减 1。 该 函数 的 类 C 伪 代码 描述 如 代码 清单 4-7 所 示 。 


图 4-11 


尝试 获取 信号 量 函 数 流程 图 


回 失败 。 


量 的 线程 阻塞 队列 中 唤醒 一 个 线程 。 











圭 县 最 














数 主 


计数 为 0 时 是 不 能 再 次 获取 的 ; 信号 量 计数 达到 最 大 值 时 有 可 能 存 








是 操作 信号 量 计 数 ， 





是 被 SR 调用 的 。 这 个 函 

















已 号 





焉 
哄 
2 
人 
二 
和 
地 


避 
地 
Ea 
洋 
过 
ES 


果 为 失败 ; 
} 


else if 
量 计数 达到 最 大 值 ) 
{ 


>? 下 交 D 
和 


安江 从 信号 合适 的 线程 ; 


10., 
没有 找到 合 
1, 


轩 的 办 大 队列 中 聊 可 二 个 
| 


12， 
信号 量 计 数 减 1 


1 } 

14. 

结果 为 成 功 ; 

5, ? 

16: else 

有 六 { 

18. 

信号 量 计数 直接 减 1 

区 

结果 为 成 功 ; 

20. 

21. 

返回 结 

22， } 

这 已 旦 . 平 又 让 

4.2.4 “信号 量 的 释放 


信号 量 的 释放 操作 主要 是 由 以 下 几 个 函数 来 完成 的 。 





' 信号 量 释放 接口 函数 xSemaphoreRelease () : 


同 ， 操 作 可 以 分 为 线程 模式 和 ISR 模 式 ， 还 可 以 进一步 细 分 为 


“ 线程 释放 信号 量 函 数 ReleaseSemaphore () 


该 函数 是 信 


为 线程 阻塞 方式 (无 限期 和 时 限 ) 、 


: 该 函数 实现 了 线程 访问 信号 量 的 核心 逻辑 。 它 首先 会 通过 函数 TryReleaseSemaphore () 尝试 


号 量 模 块 向 外 提供 的 接口 函数 ， 被 内 核 API 函 数 调用 。 它 根据 操作 模式 这 个 函 
线程 立刻 返回 和 ISR 立 刻 返 回 3 种 模式 。 另 外 由 该 函数 完成 和 信和 号 量 相关 的 内 核 数 据 的 保护 工作 。 


参数 来 区 分 处 理 本 次 信和 号 


释放 信号 量 ， 然 后 根据 结果 来 继续 操作 。 


量 的 操作 请 求 。 根 据 操 作 模式 的 不 


后 继 操 作 包 括 成 功 后 


的 线程 调度 检查 和 失败 后 的 线程 阻塞 操作 ， 它 们 都 是 在 这 里 完成 。 


“ ISR 释 放 信号 量 函 数 IsrReleaseSemaphore () : 该 函数 比较 简单 。 因 为 在 用 户 ISR 里 不 会 有 线程 调度 的 问题 (线程 调度 的 人 逻辑 在 ISR 返 回 时 由 内 核 处 理 ) 。 它 同 线程 释放 信和 号 量 函数 一 样 ， 同 样 是 调用 尝 


试 获 取信 号 量 函数 TryReleaseSemaphore () 。 
“ 尝试 释放 信号 量 函 数 TryReleaseSemaphore () : 这 个 函数 是 释放 信号 量 的 核心 部 分 ， 它 会 根据 信号 量 计 数 来 处 理 本 次 请 求 。 
“ 如 果 信号 量 计 数 已 经 为 最 大 值 ， 则 直接 返回 失败 。 


:如果 信号 量 计数 为 0， 则 需要 检查 该 信号 量 的 线程 阻塞 队列 是 否 有 线程 存在 。 如 果 有 ， 说 明 此 时 阻塞 的 线程 ， 都 是 因为 信号 量 达到 0 而 不 能 获得 信和 号 量 的 线程 ， 所 以 本 次 信号 量 操作 不 会 对 信和 号 量 计 
数 有 任何 影响 。 只 需要 在 全 部 阻塞 线程 中 找到 一 个 合适 的 线程 并 将 其 唤醒 就 可 以 了 ; 如 果 没 有 ， 则 需要 将 信号 量 计 数 加 1。 


“ 如 果 信 号 量 计数 是 中 间 值 ， 则 需要 将 信号 量 计数 加 1。 

















这 几 个 函数 的 层次 关系 比较 简单 。 注 意 xSemaphoreRelease () 起 到 的 是 分 发 调用 的 作用 ， 函 数 ReleaseSsemaphore () 和 lsrReleasesemaphore () 是 不 同 运行 环境 下 的 具体 操作 函数 ， 而 
TryReleaseSsemaphore () 则 主要 是 操作 信号 量 对 象 。 这 几 个 函数 的 流程 图 如 图 4-12 至 图 4-14 所 示 。 函 数 IsrReleaseSemaphore () 的 实现 很 简单 ， 就 不 再 详细 分 析 了 。 















































1. 信号 量 释放 接口 函数 








信和 号 量 释放 接口 函数 的 流程 图 如 图 4-12 所 示 。 


1 开始 




















六 进入 独占 区 








3 ISR 来 释放 信号 量 ? 





5 线程 释放 信号 量 


图 4-12 ”信号 量 释放 接口 函数 流程 图 





流程 图 分 析 : 











STEP2 内 核 进入 独占 区 。 


STEP3 判断 是 不 是 ISR 释 放 信 号 量 。 


STEP4 如 果 是 则 调用 ISR 释 放 信号 量 函 数 。 


STEP5 如 果 不 是 调用 线程 释放 信号 量 函 数 。 


STEP6 ”内核 退出 独占 区 。 


STEP7 函数 返回 。 








从 上 面 的 流程 图 中 可 以 看 出 ， 这 个 函数 只 是 个 接口 函数 ， 根 据 操作 类 型 判断 下 一 步 该 怎么 执行 。 











2 线程 释放 信号 量 函 数 





线程 释放 信号 量 函 数 的 流程 图 如 图 4-13 所 示 。 











线程 阻塞 阶段 


图 4-13 ”线程 释放 信号 量 函 数 流程 图 
流程 图 分 析 : 
STEP2 当前 线程 尝试 释放 信号 量 。 
STEP3 判断 本 次 释放 信和 号 量 操 作 是 否 成 功 。 
STEP4 如 果 没有 成 功 ， 则 需要 检查 本 次 操作 是 不 是 阻塞 模式 。 
STEP5 ”如果 是 ， 则 判断 内 核 是 不 是 允许 线程 调度 。 
STEP6 如 果 是 ， 此 时 需要 保存 本 次 操作 的 信息 到 线程 相关 结构 ， 并 将 自己 阻塞 在 信号 量 的 线程 阻塞 队列 。 
STEP7 向 内 核发 出 线程 调度 请 求 。 
STEP8 内 核 退 出 独占 区 ， 因 为 是 在 线程 环境 下 ， 退 出 后 极 有 可 能 发 生 线程 调度 ， 除 非 此 时 有 ISR 及 时 发 生 并 且 获 取 了 该 信号 量 ; 如 果 发 生 了 调度 则 当前 线程 被 阻塞 ， 直 到 被 再 次 唤醒 。 
STEP9 线程 被 唤醒 并 且 再 次 调度 执行 ， 在 这 里 立刻 使 得 内 核 进入 独占 区 。 


STEP10 读 取 本 次 信号 量 释放 操作 的 结果 ， 随 后 清空 当前 线程 的 IPC 缓 存 信息 。 


STEP11 如 果 在 STEP4 成 功 获得 信号 量 ， 则 需要 检查 在 释放 信号 量 的 时 候 是 不 是 唤醒 了 比 当前 线程 优先 级 更 高 的 线程 ， 如 果 没 有 ， 则 退出 函数 。 
STEP12 如 果 有 ， 则 需要 检查 内 核 此 时 是 不 是 允许 线程 调度 。 
STEP13 如 果 是 ， 则 向 内 核 申请 线程 调度 。 


STEP14 ”函数 返回 。 








从 上 面 的 流程 中 可 以 看 出 ， 在 线程 进行 信号 量 的 释放 时 ， 首 先是 通过 函数 TryRelease-Semaphore () 来 尝试 来 操作 信号 量 ， 在 尝试 的 过 程 中 可 能 成 功 也 可 能 失败 (在 成 功 的 时 候 ， 有 可 能 唤醒 了 阻塞 
在 信号 量 上 的 某 个 线程 ， 并 且 这 个 被 唤醒 的 线程 的 优先 级 可 能 比 当前 线程 更 高 ) ， 然 后 再 根据 尝试 的 结果 进行 以 下 操作 : 失败 了 可 能 需要 把 自己 阻塞 ; 成 功 了 有 可 能 需要 进行 线程 调度 。 该 函数 的 C 伪 代码 
如 代码 清单 4-8 所 示 。 





代码 清单 4-8: 线程 释放 信号 量 演示 代码 


Te 
线程 祷 放 计数 从 号 量 
- { 


如 

淮 试 释放 信号 量 ; 
4. 在 并 

成 功 释放 信号 量 ) 

5. { 

6 下 天 必 
有 更 高 优先 级 线程 被 唤醒 
并 且 

内 核 没有 关闭 线程 调度 ) 
7. { 


8. 
风机 申请 线程 调度 ; 

- } 
10. } 
DE else 
12. { 
Ls 于 在 访 
以 阻塞 方式 释放 信号 量 
并 且 
内 核 没有 关闭 线程 调度 ) 
14. { 





节 冯 线程 昌 守 在 该 信号 量 的 旧 案 队列; 

种 光线 程 调度 ; 

打开 系统 中 昕 ， 

其 计 此 处 非常 有 可 能 发 生生 次 调度 ， 除 非 线程 调度 请 求 被 内 核 取消 
当 你 理 器 再 次 处 理 本 线程 时 ， 从 本 处 继续 运行 。 */ 








27。 
返回 操作 结果 ; 
28. } 





3. 尝试 释放 信号 量 函 数 











尝试 释放 信号 量 函 数 的 流程 图 如 图 4-14 所 示 。 




















6 信和 号 量 计数 加 1 








图 4-14 ”尝试 释放 信号 量 函 数 流程 图 














流程 图 分 析 : 











STEP2 检查 信号 量 当 前 计数 是 不 是 为 最 大 值 ， 如 果 是 ， 则 返回 失败 。 


STEP3 检查 信号 量 当 前 计数 是 不 是 为 0， 如 果 不 是 ， 则 将 信号 量 计数 加 1 后 返回 。 
STEP4 ”如果 信号 量 计数 是 0， 则 尝试 从 信号 量 的 线程 阻塞 队列 中 唤醒 一 个 线程 。 
STEP5 判断 是 不 是 真 的 唤醒 了 一 个 线程 。 

STEP6 如 果 没有 ， 则 将 信号 量 计数 加 1。 

STEP10 ”函数 返回 。 


从 上 面 的 流程 图 中 可 以 看 出 ， 在 尝试 进行 信号 量 释放 时 ， 并 不 区 分 是 被 线程 调用 还 是 被 SR 调用 的 。 这 个 函数 主要 是 操作 信号 量 计数 ， 信 号 量 计数 为 最 大 值 时 是 不 能 再 次 释放 的 ; 信号 量 计 数 达 到 0 时 有 
可 能 存在 阻塞 的 线程 ， 信 号 里 计数 不 多 不 少时 ， 则 直接 加 1。 该 函数 的 C 伪 代码 如 代码 清单 4-9 所 示 。 








代码 清单 4-9: 尝试 释放 信号 量 代码 演示 





Ts 
尝试 释放 计数 信号 量 
六 { 

3 让 * 
信号 机 让 堵 到 达 员 大 ) 


号 

结果 为 失败 ; 

} 

。 else if ( 


号 量 计数 为 0) 
{ 


江 守 人 


党 试 从 信号 量 的 阻塞 队列 中 唤醒 一 个 合适 的 线 各 
有 

没有 找到 合适 的 线程 ) 

和 { 


Ss 卜 5 


1 
信号 量 计数 加 1 





4.2.5 ”终止 线程 阻塞 


线程 阻塞 在 信号 量 的 线程 阻塞 队列 时 ， 可 以 是 无 限期 的 阻塞 直到 对 信号 量 的 操作 成 功 ; 或 者 有 期 限 的 等 待 ， 在 期 限 到 达 时 如 果 仍 然 无 法 成 功 则 自动 退出 阻塞 。 这 里 的 终止 信号 量 阻塞 线程 的 操作 则 是 由 
外 部 强制 线程 解除 阻塞 ， 提 供 了 另 一 种 方式 结束 线程 对 信号 量 的 等 待 。 其 流程 图 如 图 4-15 所 示 。 


2 内 核 进 人 独占 区 








4 该 线程 优先 级 比 
前 线程 优先 级 高 ? 


xi 





5 丙 核 允许 线程 调度 3 











4-15 ”线程 阻塞 终止 函数 流程 图 











流程 图 分 析 : 











STEP2 内核 进入 临界 区 。 

STEP3 ”将 线程 从 信和 号 量 的 线程 阻塞 队列 中 解除 阻塞 。 该 函数 会 检查 指定 的 线程 是 否 阻塞 在 信号 量 的 线程 阻塞 队列 中 。 
STEP4 判断 被 解除 阻塞 的 线程 的 优先 级 是 不 是 比 当前 线程 的 优先 级 高 。 

STEP5 如 果 是 ， 则 判断 此 时 函数 是 不 是 被 线程 调用 。 

STEP6 如 果 是 ， 则 判断 此 时 内 核 是 否 允 许 线程 调度 。 

STEP7 如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 

STEP8 内 核 退 出 独占 区 ， 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线 程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP9 函数 返回 。 


4.2.6 ”信和 号 量 刷 新 


信号 量 刷新 和 信号 量 取消 初始 化 很 像 ， 不 同 的 地 方 在 于 取消 初始 化 信号 量 操作 会 导致 信号 量 计数 和 最 大 计数 均 为 0， 不 但 清空 了 信号 量 的 线程 阻塞 队列 ， 还 把 信号 量 设置 成 进入 非 初始 化 状态 ， 不 能 继续 
使 用 。 如 果 希 望 继续 使 用 则 只 能 再 次 初始 化 ; 而 信号 量 刷新 则 只 是 将 信号 量 线程 阻塞 队列 上 的 线程 全 部 唤醒 ， 这 样 的 信号 量 就 像 刚 被 初始 化 后 的 情形 ， 可 以 继续 使 用 。 信 号 量 刷新 函数 流程 图 如 图 4-16 所 


示 。 





人 








流程 图 











STEP2 


STEP3 


STEP4 


STEP5 


STEP6 


STEP7 


STEP8 


STEP9 





图 4-16 ”信和 号 量 刷新 函数 流程 图 


内 核 进 入 临界 区 。 

首先 将 信号 量 的 线程 阻塞 队列 清空 ， 把 所 有 被 阻塞 的 线程 解除 阻塞 。 保 持 信号 量 的 就 绪 属 性 。 
检查 在 清空 信号 量 的 线程 阻塞 队列 时 是 否 唤醒 了 比 当前 线程 优先 级 高 的 线程 。 

如 果 是 ， 则 判断 内 核 是 否 允 许 线程 调度 。 

如 果 是 ， 则 继续 判断 该 函数 是 否 在 被 线程 调用 。 


如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 


内 核 退 出 独占 区 ， 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线 程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


退出 函数 。 


4.3 ”信号 量 应 用 演示 


结合 前 面 介绍 的 信号 量 的 使 用 模型 和 Trochili RTOS 的 信号 量 设计 实现 ， 我 们 通过 下 面 的 几 个 实际 例 程 来 演示 信号 量 的 使 用 。 我 们 将 通过 不 同 的 信号 量 使 用 方式 实现 评估 板 上 的 LED 灯 的 点 亮 和 熄灭 。 




















4.3.1 ”线程 间 的 信号 量 单 向 同步 


在 本 例 中 ， 我 们 通过 两 个 线程 的 同步 配合 ， 实 现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 其 中 主 控 线 程 不 停 地 以 非 阻塞 方式 释放 信号 量 ， 每 次 释放 信号 量 后 延 时 休眠 1 秒 ; LED 线 程 则 不 停 地 以 阻塞 方式 尝 


得 位 旦 量 
信鸽 写 星 ， 


在 这 个 


代码 清单 4- 


j 户 线程 


pd batt 


5 
用 户 线程 


23: 


第 一 次 得 到 信号 量 后 就 点 亮 LED， 然 后 等 待 下 次 得 到 信号 量 后 就 关闭 LED， 循 环 往复 。 


例 程 里 ，LED 线 程 和 主 控 线程 的 同步 是 单 向 的 ， 即 主 控 线 程 的 运行 不 依赖 LED 线 程 ;而 LED 线 程 的 执行 则 依赖 于 主 控 线 程 的 信号 量 





10: 信号 量 应 用 例 程 1 








#include "example.h" 
#inclugde “trochili.h" 


#if (EVB EXAMPLE 一 CH4 SEMAPHORE EXAMPLE1) 


2 于 

#define THREAD LED STRACK SIZE (256) 
#define THREAD LED PRIORITY tS 
#define THREAD LED SLICE (20) 


#define THREAD CTRL STACK SIZE (256) 
#define THREAD CTRL PRIORITY (6) 
#define THREAD CTRL SLICE (20) 


1 
栈 定义 */ 

static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
static TWord ThreadCTRLStack [THREAD CTRL : STACK _ SIZE]; 


static TThread ThreadLED; 
static TThread ThreadCTRL; 


/* 


甩 记 信守 是 定义 





static TSemaphore LedSemaphore; 


/* LED 


的 主 函 数 */ 


static void ThreadLEDENtry (void* pArg) 


TErrno errno; 
TState state; 
while (eTrue) 


{ 


34. LIED 
总 委 以 上 守 广 式 区 取舍 号 量 ， 得 到 后 点 亮 LED */ 


state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
if (state == eSuccess) 
{ 
EVB_LEDControl (LED1, LED ON); 
} 


/* LED 


释放 操作 。 程 序 实现 如 代码 清 


单 4-10 所 示 。 





线程 以 阻塞 方式 获取 信号 量 ， 得 到 后 熄灭 LED */ 
42 


43 
44 


state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
if (state 一 eSuccess) 


EVB LEDControl (LED1, LED OFF); 


SL FE 
主 控 线 程 的 主 函 数 */ 
52 


533 
54. 
35 
56. 


57; 
主 控 线 程 延 时 1 


秒 */ 
58. 
59. 


60 . 
主 控 线 程 释 放 信号 量 */ 
61. 


2 
&3。 
64. 
65: 
66 


SIs 
68. 
9 
10. 
31 


设备 
72. 
73. 
74. 


初始 化 信号 量 */ 
75 


76. 
77- 











激活 主 控 线程 */ 
91. 


static void ThreadCTRLENtry (void* pArg) 
{ 

TErrno errno; 

while (eTrue) 


TclDelayThread (uThreadCurrent, MLS2TICKS(1000)); 


TclReleaseSemaphore (&LedSemaphore, 0, 0, &errno); 
} 
} 


二 
用 户 应 用 入 口 函 数 */ 


static void EVB LEDAppEntry (void) 
{ 


TErrno errno; 


/* 
配置 使 能 评估 板 上 的 LED 


$x 
EVB LEDConfig (); 


/* 
TclInitSemaphore (&LedSemaphore, 0, 1, IPC PROP NONE, &errno); 


/* 


化 LED 
控制 线程 */ 


TclInitThread (&ThreadLED，&ThreadLEDEntry， (void*)NULL, 
ThreadLEDStack, THREAD LED STACK SIZE, 
THREAD LED PRIORITY, THREAD LED SLICE); 

/* 

TclInitThread (&ThreadCTRL， &ThreadCTRLENtry, (void*)NULL, 
ThreadCTRLStack, THREAD CTRL STACK SIZE, 
THREAD CTRL PRIORITY, THREAD CTRL SLICE); 


i 


TclActivateThread (&ThreadLED); 
/* 


TclActivateThread (&ThreadCTRL); 


了 


处 理 器 BOOT 
之 后 会 调用 main 


96. 
97. 
98 . 


99, 
i100. 
101 


102 
103. 
104 


i103. 
106. 
107 





108. 
109, 
i110 


必须 提供 */ 
int main (void) 


{ 


id 
注册 处 理 器 初始 化 函数 到 内 核 */ 


TclSetCpuEntry (&STM32F10xInit); 


; a 
注册 板 级 初始 化 函数 到 内 核 */ 


TclSetBoardEentry (&EVB_SetupBoard); 


4 A 
注册 板 级 调试 打印 函数 到 内 核 */ 


TclSetTraceRoutine (&EVB_Uart1WNriteString) 7 


注册 用 户 初始 化 函数 到 内 核 */ 


TclSetUserEntry (&EVB_LEDAppEntry); 


大 


启动 内 核 */ 


111, 
112 
113: 
114. 
L115 
i116 


TclStartKernel (); 


return 1; 


} 
#endif 








程序 运行 后 ，LED 的 变化 如 图 4-17 所 示 。 








PP TT 
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一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 
























一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 


和 





-------+-—-------+--------+--------+----------------——- 


PP 


ON ; OFF | ON | OFF | ON 


忆 忆 二 一 一 一 一 一 一 一 一 下 二 二 一 忆 二 一 二 一 中 一 一 一 一 一 一 一 一 下 二 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 - 
1 
1 
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一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 








四 四 四 四 四 四 四 中 一 一 一 一 一 一 一 一 


ON ; OFF ; ON | OFF ; ON | OFF 





一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 


Pe 
击 生 本 六 浪 生 剖 剖 训 
i 

1 

1 

1 

1 

1 

1 

1 
Pe 
和 
ds 














时 间 








4-17 LED 的 变化 情况 








4.3.2 ”线程 间 的 信号 双向 同步 





























在 本 例 中 ， 我 们 通过 两 个 线程 的 同步 配合 ， 实 现 两 个 LED 分 别 按照 1 秒 的 间隔 点 亮 和 熄灭 。 这 里 使 用 了 两 个 信号 量 。 























LED 线 程 1 首先 以 阻塞 方式 获得 信号 量 1， 得 到 后 则 点 亮 LED1， 延 时 1 秒 后 再 关闭 LED1， 最 后 以 非 阻塞 方式 释放 信号 量 2。 




















LED 线 程 2 首先 点 亮 LED2， 延 时 1 秒 后 再 关闭 LED2。 然 后 以 非 阻 塞 方式 释放 信号 量 1， 最 后 以 阻塞 方式 获得 信号 量 2。 


在 这 个 例 程 里 ， 两 个 LED 线 程 的 同步 是 双向 的 ， 即 LED1 线 程 的 运行 依赖 LED 线 程 2; LED 线 程 2 的 执行 也 依赖 于 LED 线 程 1， 因 为 它们 的 运行 都 依赖 于 某 个 信号 量 的 操作 。 





程序 实现 如 代码 清单 4-11 所 示 。 


代码 清单 4-11: 信号 量 应 用 例 程 2 























Ts #include "example.h" 
总 #include "trochili.h" 
3。 
4. #if (EVB EXAMPLE == CH4 SEMAPHORE EXAMPLE2) 
Ss 
6 Ar 
用 户 线程 参数 */ 
Tt #define THREAD LED STACK SIZE (256*2) 
Ys #define THREAD LED PRIORITY (5) 
9。 #define THREAD LED SLICE (20) 
10. 
1 
用 户 线程 栈 定义 */ 
12; static TWord ThreadLED1Stack[THREAD LED STACK SIZE]; 
1 static TWord ThreadLED2Stack[THREAD LED STACK SIZE]; 
14. 
15。 hs 
用 户 线程 定义 */ 
Ls static TThread ThreadLED17 
TT static TThread ThreadLED2; 
16. 
19, A 
用 户 信号 量 定义 */ 
20. static TSemaphore LedSemaphorel; 
le static TSemaphore LedSemaphore2; 
22: 
23. /* LED 
数 二 
24. static void ThreadLEDlEntry (void* pArg) 
25, { 
26. TErrno errno; 
27. 
28 . while (eTrue) 
29. ‘ 
30. /* LED 
线程 1 
以 阻塞 方式 获取 信号 量 1 
， 如 果 成 功 就 点 亮 LED1*/ 
> TclObtainSemaphore (&LedSemaphorel, IPC OPT WAIT, 0, &errno); 
32。 EVB_LEDControl (LED1, LED ON); 
33。 
34. /* LED 
线程 1 
延 时 1 
秒 后 关闭 LED1 */ 
EE TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 
36. EVB_LEDControl (LED1, LED OFF); 
37: 
38. /* LED 
线程 
以 非 阻塞 方式 释放 信号 量 2 */ 
S39 TclReleaseSemaphore (&LedSemaphore2, IPC OPT NONE, 0, &errno); 
40. 
41. } 
42. 
43. /* LED 
线程 2 ， 
的 主 函数 */ 





static void ThreadLED2Entry (void* pArg) 
{ 


TErrno errno; 


while (eTrue) 


{ 





/* LED 
LED2 */ 
EVB_LEDControl (LED2, LED ON); 
/* LED 
延 时 1 
秒 后 关闭 LED2 */ 
54. TclDelayThread (uThreaqCurrent，MLS2TICKS (1000) ) 7 
55: EVB_LEDControl (LED2, LED OFF); 
56. 
BT /* LED 
线程 2 
以 非 阻塞 方式 释放 信和 号 量 1 */ 
58 . TclReleaseSemaphore (&LedSemaphorel, IPC OPT NONE,0, &errno); 
S59 
60 . /* LED 
线程 2 
以 阻塞 方式 获取 信号 量 2 */ 
61. TclObtainSemaphore (&LedSemaphore2, IPC OPT WAIT, 0, &errno); 
62 . } 
63。 } 
64. 
65. 
66. 人 
用 户 应 用 入 口 函 数 */ 
67 . static void APP LEDEntry (void) 
68 . { 
G9 TErrno errno; 
70. 
71. ee 
配置 使 能 评估 板 上 的 LED 
设备 */ 
72 . EVB_ LEDConfig () 7 
73. 


74. 
初始 化 信号 量 */ 
5 TclInitSemaphore (&LedSemaphorel, 0, 1,IPC PROP NONE, &errno); 


76. TclInitSemaphore (&LedSemaphore2, 0, 1, IPC PROP NONE, &errno); 
21 
78. Et 


初始 化 LED 


设备 控制 线程 1 */ 
79. 


TclInitThread (&ThreadLED]1, &ThreadLED1PntzY， 


(void*) NULL, 


80. ThreadLED1Stack, THREAD LED STACK SIZE, 
81. THREAD LED PRIORITY, THREAD LED SLICE); 


2 


83. 
初始 化 LED 
设备 槐 制 线 各 2 / 


四 


TclInitThread (&ThreadLED2, &ThreadLED2EnNtry, 


(void*) NULL, 


5 ThreadLED2Stack, THREAD LED STACK SIZE, 
86. THREAD LED PRIORITY + 1, THREAD LED SLICE); 


1 


88. 

激活 LED 
线程 */ 
89. TclActivateThread (&ThreadLPD1) 7 
90 . 


91。 

激活 LED 
线程 2 */ 
92 . TclActivateThread (&ThreadLED2) 7 
93 } 

94. 

95, WR 

处 理 器 BOOT 

之 后 会 调用 main 
函数 ， 必 须 提供 */ 


/* 


/* 


96. int main (void) 

97 。 { 

98 . 水 

注册 处 理 器 初始 化 函数 到 内 核 */ 

99 。 TclSetCpuEntry (&CPU_STM32F10xInit); 
100. 


101. iy 
注册 板 级 初始 化 函数 到 内 核 */ 


102. TclSetBoardEentry (&EVB_SetupBoard); 

103. 

104._ A 

注册 板 级 调试 打印 函数 到 内 核 */ 

1I05。 TclSetTraceRoutine (&EVB_Uart1WNriteString) 7 
106. 


107. dy 
注册 用 户 初始 化 函数 到 内 核 */ 





108 . TclSetUserEntry (&APP LEDENtry); 
109, 

110. A 

启动 内 核 */ 

111. TclStartKernel (); 
i112 

3 return 1; 

114. } 

L115. 

Ll. 

II。 #endif 








程序 运行 后 ，LED 的 变化 如 图 4-18 所 示 。 











LED2| ON 


LEDI1| OFF 


一 一 一 一 站 一 一 一 一 中 一 一 一 一 站 二 二 二 二 十 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 - 
一 一 一 一 下 二 二 忆 二 中 一 一 一 一 业 王 二 十 一 省 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 - 


一 一 一 一 丰 一 一 -- 区 于 生生 和 和 一 一 一 一 





4.3.3 ”线程 和 ISR 的 信号 同步 


线程 和 ISR 间 的 信号 同步 ， 一 般 来 说 是 单 向 的 ， 因 为 1SR 不 能 被 阻塞 ， 线 程 可 以 等 待 信号 量 ， 而 1SR 不 会 等 待 信号 量 ， 也 就 不 存在 同步 的 问题 。 
了 某 些 事件 源 ， 而 线程 是 等 待 处 理 这 些 事件 。 线 程 和 1SR 之 间 ， 有 明确 的 分 工 和 单 向 同步 的 应 F 











在 本 例 中 ,我们 通过 1 个 LED 线 程 和 1 个 按键 中 断 来 进行 同步 ， 实 现 LED 的 点 亮 和 熄灭 。 这 和 
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4-18 ”LED 的 变化 情况 


中 








从 实际 应 用 的 角 

















模型 。 














度 讲 ，ISR 是 中 断 引 起 的 ， 可 以 理解 为 代表 


使 用 了 1 个 信号 量 。LED 线 程 不 停 地 以 阻塞 方式 尝试 获得 信号 量 ， 第 一 次 得 到 信号 量 后 就 点 亮 LED， 然 后 等 待 





下 次 得 到 信号 量 后 就 熄火 LED， 循 环 往复 。 而 在 按键 1SR 中 ， 直 接 以 |SR 模 式 释放 信号 量 ， 然 后 退出 。 程 序 实现 如 代码 清单 4-12 所 示 。 


代码 清单 4-12: 信号 量 应 用 例 程 3 





1 #include"example.h" 

2。 #include"trochili.h" 

3 

4. #if (EVB EXAMPLE == CH4 SEMAPHORE EXAMPLE3) 
:站 

6.、 /* 

用 户 线程 参数 */ 

汪 人 #define THREAD LED STACK SIZE (256) 
#define THREAD LED PRIORITY 45) 

网 #define THREAD LED SLICE (20) 
10. 

11. #define THREAD CTRL STACK SIZE (256) 
了 全 #define THREAD CTRL PRIORITY (6) 
nic #define THREAD CTRL SLICE (20) 


15: ke 
用 户 线程 栈 定义 */ 
16 


static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 


下 
18 . 


用 户 线 
19 
20. 
2 
用 户 信 
22 . 
23: 


24. 
线程 的 
25; 
26. 
27. 
28. 
29. 
30. 


31， 
线程 以 
32. 
33。 
34. 
35. 


5 
ITs 


38 . 
39 


40 . 
41. 
42. 
43. 
44. 
45. 
46. 


47 . 
评估 板 
48. 


52: 
以 非 阻 
必须 ) 
释放 信 
53。 
54。 
55. 
56. 

号 了。 

用 户 应 
58 . 


配置 使 


设置 和 
相关 的 
67. 





注册 处 


87. 
注册 板 
88. 
89. 
90 . 
注册 板 
91 . 
92 . 
93 
注册 用 
94. 

95. 


96. 
启动 内 
97. 
98. 
99. 
100. 


101. 
102, 









程 定义 */ 
static TThread ThreadLED; 


/* 
号 量 定义 */ 
static TSemaphore LedSemaphore; 


/* LED 
数 */ 





static void ThreadLEDEnNtry (void* pArg) 


{ 
TErrno errno; 
TState state; 
while (eTrue) 


/*_ LED 
阻塞 方式 获取 信号 量 ， 如 果 成 功 则 点 亮 LED */ 


state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 


if (state == eSuccess) 


EVB_LEDControl (LED1, LED ON); 


} 


/*_ LED 
阻塞 方式 获取 信号 量 ， 如 果 成 功 则 熄灭 LED */ 


state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 


if (state == eSuccess) 


EVB_LEDControl (LED1, LED OFF); 


bE: 


/* 
按键 中 断 处 理 函 数 */ 


static void EVB KeyISR (TVector vector, TProperty Property, TWord data) 


{ 
if (EVB KeyScan()) 
{ 


/* Key ISR 
塞 方式 ( 


号 量 */ 


TclIsrReleaseSemaphore (&LedSemaphore) 7 


六 
用 程序 入 口 函数 */ 
static void APP LEDEntry (void) 
{ 


TErrno errno; 
人 
能 评估 板 上 的 LED 


EVB_LEDConfig (); 
EVB_ KeyConfig(); 


/x* 
KEY 
外 部 中 断 向 量 * 


TclSetIntVector (KEY_INT VECTOR, &EVB KeyISR, 0); 


/* 


信号 量 */ 


TclInitSemaphore (&LedSemaphore, 0, 1, IPC PROP NONE, &errno); 


/* 


/* 


TclActivateThread (&ThreadLED); 


， 必 须 提 供 */ 


int main (void) 


{ 
/* 
理 器 初始 化 函数 到 内 核 */ 


TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
ThreadLEDStack, THREAD LED STACK SIZE, 
THREAD LED PRIORITY, THREAD LED SLICE); 


TclSetCpuEntry (&CPU_STM32F10xInit); 


Ar 
级 初始 化 函数 到 内 核 */ 


Tc1SetBoardEntrYy(&EVB_SetupBoard) 7 


/* 
级 调试 打印 函数 到 内 核 */ 


TclSetTraceRoutine (&EVB UartlWriteString); 


/* 
户 初始 化 函数 到 内 核 */ 
TclSetUserEntry (&APP LEDENtry); 
大 
核 */ 
TclStartKernel () 7 


return 1; 


} 


#endif 





这 个 例子 不 是 很 方便 图 


4.3.4 


在 本 例 中 ， 实 现 2 个 Uart 线 程 间 的 同步 。2 个 线程 分 别 向 串口 打印 代表 各 自 的 字符 串 。 因 为 时 间 片 调 





线程 间 的 资源 共享 


示 ， 请 读者 自己 实际 动手 测试 吧 。 























换 出 去 ， 那 么 串口 打印 的 字符 串 很 可 能 是 乱 的 ， 而 加 上 
结束 后 才能 被 再 次 访问 。 程 序 实现 如 代码 清单 4-13 所 示 。 




















代码 清单 4-13: 信号 量 应 用 例 程 4 


#include "example.h" 


口 保护 ， 即 使 某 个 线程 没有 打印 完毕 ， 也 不 








担心 别 的 线程 使 





























申 














。 这 时 的 信号 








的 作 


就 是 把 可 能 的 带 冲突 的 资源 访问 





度 机 制 ， 如 果 没 有 任何 保护 ，2 个 线程 在 向 串口 发 送 字符 串 时 ， 很 可 能 还 没完 整 发 送 完毕 就 被 调度 切 








行 化 ， 一 次 访问 必须 


#include "trochili.h" 
#if (EVB EXAMPLE == CH4 SEMAPHORE EXAMPLE4) 


#define THREAD SYNC ENABLE (1) 


/* 
j 户 线程 参数 */ 
#define THREAD UART STACK SIZE (256*2) 
0;: #define THREAD UART PRIORITY (5) 
Ts #define THREAD UART SLICE (20) 
25 
3, 
广 线 程 槛 定义 wy 


static TWord ThreadUartLowCaseStack[THREAD UART STACK SIZE]; 
static TWord ThreadUartUpCaseStack[THREAD UART STACK SIZE]; 


OO 


Fg 
有 户 线程 定义 */ 


尖 凡 BB 名 表 SS 吕 NES YE PD 








static TThread ThreadUartLowCase; 
9. static TThread ThreadUartUpCase; 
0. 

a 人 

户 信号 量 定义 */ 

static TSemaphore UartSemaphore; 
23. 

24. 


字符 打印 函数 ， 通 过 BSP 
将 字符 串 输出 到 评估 板 的 串口 */ 


人 static void PrintfString (char* str) 
26. { 

Rs TErrno errno; 

ZB TState state; 

29 


30% A* 
当前 线程 以 阻塞 方式 获取 信号 量 ， 成 功 后 通过 BSP 
打印 字符 串 */ 











SLs #if (THREAD SYNC ENABLE) 
ep state = -TclObtainSsemaphore (&UartSemaphore, IPC OPT WAIT, 0, &errno); 
区 和 if (state 一 eSuccess) 
34. { 
35, uKernelTrace (str); 
36 } 
37; 1 
字符 串 完全 打印 后 ， 当 前 线程 以 非 阻塞 方式 释放 信和 号 
38 人 0, 0, &errno); 
39. #else 
40. errno = errno; 
41. state = state; 
42. UKernelTrace (str); 
43. #endif 
44. F 
45. 
46. J 
打印 大 写字 符 串 线程 的 主 函 数 */ 
47. static void ThreadUartLowCaseEntry (void* pArg) 
48. { 
49. while (eTrue) 
50 . $ 
SL PrintfString ("ABCDDEFGHIJK\r\n"); 
525 } 
53. 了 
54. 
553 2 
打印 小 写字 符 串 线程 的 主 函 数 */ 
起 全 static void ThreadUartUpCaseEntry (void* pArg) 
ST { 
58; while (eTrue) 
59. { 
60. PrintfString ("abcdefghijk\r\n"); 
61. } 
62. 和 
63. 
64. 
65. 
用 户 应 用 程序 入 口 函数 */ 
66. static void APP UartEntry (void) 
67. { 
68 . 
9 TErrno errno; 
2 

J 
和 化 人 量 */ 

TclInitSemaphore (&UartSemaphore, 1, 1, IPC PROP NONE, &errno); 
人 
74. 2 
初始 化 UART 
设备 控制 线程 */ 
5 TclInitThread (&ThreadUartLowCase, &ThreadUartLowCaseEntry, (void*)NULL, 
0 ThreadUartLowCaseStack, THREAD UART STACK SIZE, 
RT THREAD UART PRIORITY, THREAD UART SLICE); 
J8: 
J 
初始 化 UART 
设备 控制 线程 */ 
80. TclInitThread (&ThreadUartUpCase, &ThreadUartUpCaseEntry, (void*)NULL, 
81. ThreadUartUpCaseStack, THREAD UART STACK SIZE, 
82. THREAD UART PRIORITY, THREAD UART SLICE)7 
3 
84. 2 
激活 UART 
小 写 线程 */ 
Bs TclActivateThread (&ThreadUartLowCase); 
86. 
87. Va 
激活 UART 
大 写 线程 */ 
88 . TclActivateThread (&ThreadUartUPCase) 
89. J 
80 
91。 /+ 
处 理 器 BOOT 
之 后 会 调用 main 
函数 ， 必 须 提供 */ 
92 . int main (void) 
93 . { 
94. Fg 
注册 处 理 器 初始 化 函数 到 内 核 */ 
95 . TclSetCpuEntry (&CPU_STM32F10xInit) 7 
96. 
7 i 
注册 板 级 初始 化 函数 到 内 核 */ 
98. TclSetBoardEentry (&EVB_SetupBoard); 
99. 
100. 
注册 板 级 调试 打印 函数 到 内 核 */ 
hs TclSetTraceRoutine (&EVB UartlWriteString); 
102. 
103 
注 骨 户 初始 化 入 数 到 内 核 3 
104. TclSetUserEntry (&APP UartEntry); 
105. 
106. 
启动 内 核 */ 
107. TclStartKernel (); 
108. 
109. return 1; 
Ek 


TS 


112. 
113s #endif 








程序 运行 后 ， 串 口 的 打印 结果 如 图 4-19 所 示 。 











abcdefehi jk 














4-19 ”串口 的 打印 结果 





我 们 分 析 一 下 这 个 记录 : 

“ 开始 几 行 字符 都 是 同样 的 大 写字 符 ， 这 说 明 线 程 UpCase 正 在 执行 。 

“ 然后 在 第 一 次 小 写字 符 串 的 地 方 稍 靠 前 些 的 某 个 位 置 ， 发 生 时 间 片 调度 ， 此 时 线程 UpCase 已 经 报 串 口 保护 起 来 了 。 
“ 线程 LowCase 得 到 处 理 器 开始 运行 ， 但 因为 得 不 到 串口 从 而 阻塞 在 串口 信号 量 的 线程 阻塞 队列 上 。 

: 线程 LowCase 必 须 让 出 处 理 器 。 

“ 线程 UpCase 得 到 处 理 器 继续 打印 大 写字 符 串 。 

“ 当 线 程 UpCase 完 整 打印 一 个 大 写字 符 串 之 后 ， 线 程 UPCase 开 始 释放 信号 量 。 

“ 因为 线程 LowCase 正 在 等 待 信号 量 ， 所 以 线程 LowCase 得 到 信号 量 。 

“ 线程 UpCase 继 续 运行 ， 尝 试 获得 信号 量 ， 因 为 信号 量 已 经 被 线程 LowCase 得 到 ， 所 以 线程 UpCase 阻 塞 ， 线 程 LowCase 开 始 运行 。 
“ 线程 LowCase 打 印 一 个 完整 的 小 写字 符 串 后 ， 释 放 信 号 量 。 

: 因为 线程 UpCase 正 在 等 待 信号 量 ， 所 以 线程 UpCase 得 到 信号 量 。 

“ 线程 UpCase 得 到 处 理 器 继续 打印 大 写字 符 串 。 

“ 两 个 线程 开始 交替 打印 完整 的 字符 串 ， 循 环 往复 。 


读者 可 以 通过 设置 仿真 器 断 点 来 分 析 上 面 的 过 程 。 假 如 没有 通过 信号 量 保护 串口 ， 那 打印 结果 很 可 能 出 现 大 小 写字 符 串 交 错 的 情况 ， 如 图 4-20 所 示 。 




















abcdefghijk 
abcdefghijk 
abcdefghijk 
abcdefghijk 
ab 


ABCDDEFGHIJK 
ABCDDEFGHIJK 
ABCDDEFGHIJK 


ABCDDEFGHIJK 
ABCDDEFGHIJK 
ABCDDEFGHIJK 
ABCDDEFGHIJK 


hBCDDEFGHIJKcdefghijk 


abcdefghijk 
abcdefghijk 
abcdefghijk 


4.3.5 “多 线程 的 信号 同步 


在 本 例 中 ， 实 现 多 个 LED 线 程 和 1 个 控制 线程 的 单 向 同步 。 实 现 3 个 LED 分 别 按照 1 秒 的 间隔 点 亮 和 熄灭 。 





具体 实现 时 ， 多 个 LED 线 程 的 线程 函 


代码 清单 4-14: 信号 量 应 用 例 程 5 









































数 相 似 ， 都 是 以 阻塞 方式 等 待 某 个 信号 量 (去 获取 或 者 释放 ， 


隔 1 秒 对 信和 号 量 进行 一 次 FLUSH 操 作 ， 使 得 那些 阻塞 在 信号 量 线程 阻塞 队列 上 的 线程 都 解除 阻塞 。 具 体 实现 如 代码 清和 











4-20 ”未 使 用 信和 号 量 保护 串口 得 到 的 打印 结果 


这 里 使 用 了 1 个 信号 量 。 
































的 是 阻塞 在 信号 量 的 线程 阻塞 队列 上 ， 使 得 多 个 线程 的 执行 路 径 交 汇 在 一 起 ) 。 
4-14 所 示 。 








而 控制 线程 则 是 每 





Ls #include "example.h" 

总 #include "trochili.h" 

站 

4. #if (EVB EXAMPLE 一 CH4 SEMAPHORF, FXAMPLES) 
5 

让 /* 

用 户 线程 DA ey 

和 #define THREAD LED STACK SIZE (256) 
8. #define THREAD LED PRIORITY (5) 
9。 #define THREAD LED SLICE (20) 
10. 

E #define THREAD CTRL STACK SIZE (256) 
坦 ， #define THREAD CTRL PRIORITY (6) 
TS #define THREAD CTRL SLICE (20) 
14. 

5 


15。 
用 户 线程 栈 定义 */ 
16. 


static TWord ThreadqLED1Stack[THREAD LED STACK SIZE]; 


[ ]; 
17; static TWord ThreadLED2Stack[THREAD LED STACK SIZE]; 
18; static TWord ThreadLED3Stack[THREAD LED STACK SIZE]; 
TS static TWord ThreadCTRLStack[THREAD CTRL STACK SIZE]; 
20. 
21. 
22. 二 
用 户 线 程 定义 */ 
区 static TThread ThreadLED17 
24. static TThread ThreadLED2; 
25. static TThread ThreadLED3; 
26. static TThread ThreadCTRL; 


Pin 
因 庆 信 和 六 定义 这 


/* LED 


数 */ 
static void ThreadLED1EN 
人 





TErrno errno; 
TState state; 
while (eTrue) 





/* LED 


线程 1 
以 明 玉 式 获取 信号 量 ， 如 果 信号 
则 点 亮 对 应 的 LED */ 


static TSemaphore LedSemaphore; 


try (void* pArg) 


量 被 Flush 


39。 es = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
40. if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 

41. 

42 . EVB_LEDControl (LED1, LED ON); 

43. } 

44. 

45. /* LED 

线程 1 

以 阻塞 方式 获取 信号 量 ， 如 果 信号 量 被 FLush 

则 熄灭 对 应 的 LED */ 

46. state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
47. if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 

48 . { 

49. EVB LEDControl (LED1, LED OFF); 

50. } 

Ss 3 

32 } 

53. 

54 /* LED 


的 主 函数 */ 





55 
El 
Ry 
58;, 
29 
60. 


61. 
线程 1 


static void ThreadLED2Entry (void* pArg) 
{ 

TErrno errno; 

TState state; 

while (eTrue) 


/* LED 


以 阻塞 方式 获取 信号 量 ， 如 果 信号 量 被 FLush 


则 点 亮 对 应 的 LED */ 
62 . 


53， 
64. 
065 
66. 
G7 


68. 
线程 1 


state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 


EVB_LEDControl (LED2, LED ON); 
了 


/* LED 


以 阻塞 方式 获取 信号 量 ， 如 果 信号 量 被 Flush 
则 熄灭 对 应 的 LED */ 


69 . 
70 . 
RE 
2 
A 
74. 
Ys 
76. 


77， 
线程 3 


state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 


EVB_LEDControl (LED2, LED OFF); 


} 


/* LED 


的 主 函数 */ 





78. 
79. 
80. 
81. 
82. 
83. 
84. 
线程 1 


static void ThreadLED3Entry (void* pArg) 
{ 

TErrno errno; 

TState state; 

while (eTrue) 


/* LED 


以 阻塞 方式 获取 信号 量 ， 如 果 信号 量 被 Flush 
则 点 亮 对 应 的 LED */ 


85. 
86. 
87. 
88. 
89. 
90. 
91. 
线程 1 


state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 


EVB_LEDControl (LED3, LED ON); 
} 


/* LED 


以 阻塞 方式 获取 信号 量 ， 如 果 信号 量 被 FLush 


则 熄灭 对 应 的 LED */ 
92 . 


3 
94. 
5 
S65 
Ty 
86; 
人 启 
100. 
101. 


state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 


EVB_LEDControl (LED3, LED OFF); 


/* 








主 控 线程 的 主 函 数 */ 








102. 
103, 
104. 
A 
106. 
107 


控制 线程 延 时 1 


static void ThreadCTRLENtry (void* pArg) 
{ 

TErrno errno; 

while (eTrue) 

{ 


/* 


秒 后 FLUSH 
信号 量 的 线程 阻塞 队列 */ 


108 . 
109 . 
110 . 
a 
4 
3 
114 





TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 
TclFlushSemaphore (&LedSemaphore, &errno) 


和 A 
用 户 应 用 入 口 函 数 */ 


Es static void APP LEDENtry (void) 
116. 

中 TErrno errno; 

118. 

119. py 

配置 使 能 评估 板 上 的 LED 

设备 */ 

120 EVB LEDConfig () 7 

121. = 

122; pg 

初始 化 时/ 

123。 TclInitSemaphore (&LedSemaphore, 0, 1, IPC PROP NONE, &errno); 
124. 

T3252 7 

初始 化 LED 


设备 控制 线程 */ 


L226 TclInitThread (&ThreadLED1, &ThreadLED1Pntry， (void*)NULL, 
E27 ThreadLED1Stack, THREAD LED STACK SIZE, 
128. THREAD LED PRIORITY, THREAD LED SLICE); 
129. 

130 . /* 

初始 化 LED 


设备 控制 线程 */ 


31% TclInitThread (&ThreadLED2, &ThreadLED2EnNntry, (void*)NULL, 
uc ThreagdLED2Stack, THREAD LED STACK SIZE, 
133, THREAD LED PRIORITY, THREAD LED SLICE); 
134. 

135. jt 

初始 化 LED 


设备 控制 线程 */ 


136 . TclInitThread (&ThreadLED3, &ThreadLED3EnNntry, (void*)NULL, 
Las ThreagdLED3Stack, THREAD LED STACK SIZE, 
138. THREAD LED PRIORITY, THREAD LED SLICE); 

3 

140 . 2 

初始 化 CTRL 

线程 */ 

a TclInitThread (&ThreadCTRL， &ThreadCTRLENtry, (void*)NULL, 
142. ThreadCcTRLStack, THREAD CTRL STACK SIZE, 
143. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
144. 





65s 


96 





/* 


TclActivateThread (&ThreadLED1); 
TclActivateThread (&ThreadLED2); 
TclActivateThread (&ThreadLED3); 


/* 


中 
TclActivateThread (&ThreadCTRL); 


/* 
处 理 器 BOOT 

之 后 会 调用 main 
函数 ， 必 须 提供 * 


int main (void) 


LS 
158s 


159, 
160. 
161 


52 
163. 
164 


165 
166. 
167 








168. 
169. 
170. 
启动 内 核 
171. 
172; 
7 3 
174. 
175% 
176. 
177. 


{ 


A 


/* 
注册 处 理 器 初始 化 函数 到 内 核 */ 


TclSetCpuEntry (&CPU_STM32F10xInit); 


; a 
注册 板 级 初始 化 函数 到 内 核 */ 


TclSetBoardEentry (&EVB_SetupBoard); 


, Ea 
注册 板 级 调试 打印 函数 到 内 核 */ 


TclSetTraceRoutine (&EVB UartlWritestring); 


注册 用 户 初始 化 函数 到 内 核 */ 


TclSetUserEntry (&APP LEDENtry); 
大 
TclStartKernel () 7 


return 1; 


#endif 








程序 运行 后 ，LED 的 变化 如 图 4-21 所 示 。 

















一 一 一 一 是 本 本 丁酉 尖 一 一 一 一 届时 融 本 十 关 一 一 一 一 吉 加 加 加 本 枯 一 一 一 一 一 一 一 一 一 一 一 = 
一 
一 = 一 








4-21 








4.3.6 ”强制 解除 线程 阻塞 


= == 


LED 的 变化 情况 


一 一 一 一 下 一 一 一 一 中 一 一 一 一 下 一 本 中 中 一 一 一 一 上 一 一 呈正 中 一 一 一 一 一 一 一 一 一 一 一 
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一 一 一 了 一 









在 本 例 中 ， 两 个 线程 通过 信号 量 的 操作 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭。 其 中 LED 线 程 首先 以 阻塞 方式 尝试 获取 信号 量 ， 如 果 LED 线 程 被 解除 在 信号 量 上 的 阻塞 则 点 亮 LED;， 然后 再 次 以 阻塞 方式 尝 
试 获 取信 号 量 ， 如 果 LED 线 程 再 被 解除 阻塞 则 熄灭 LED， 主 控 线 程 则 首先 延 时 1 秒 后 ， 然 后 强制 解除 LED 线 程 的 阻塞 ;循环 往复 。 程 序 实现 如 代码 清单 4-15 所 示 。 


代码 清单 4-15: 信号 量 应 用 例 程 6 





Hrdp 


j 户 线程 


oo -1 


15 


#include "example.h" 
#inclugde “trochili.h" 


#if (EVB EXAMPLE == CH4 SEMAPHORE EXAMPLE6) 


/* 
参数 */ 

#define THREAD LED STACK SIZE (256) 
#define THREAD LED PRIORITY (5) 


#define THREAD LED SLICE (20) 


#define THREAD CTRL STACK SIZE (256) 
#define THREAD CTRL PRIORITY (4) 
#define THREAD CTRL SLICE (20) 


/* 


用 户 线程 栈 定义 */ 
static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
static TWord ThreadCTRLStack[THREAD CTRL STACK SIZE]; 


16. 
17. 
18. 
19， 
用 户 线程 
20 


2 
才 。 
这 了 


/* 


定义 */ 


static TThread ThreadLED; 
static TThread ThreadcTRL; 


/* 


用 户 信号 量 定义 */ 
static TSemaphore LedSemaphore; 


24. 
六 


2。 
2 
308 
3 
32: 


35 
20 
Ts 
38 
3 


26. /* LED 
线程 的 主 函数 */ 
static void ThreaqLEDEntry (void* pArg) 


{ 


TErrno errno; 
TState state; 
while (eTrue) 


/*_LED 


33。 
态 检 以 阴 各 为 式 黎 取得 号 量 ， 如 果 阻 塞 被 强制 解除 则 点 亮 LED */ 


state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
if ((state != eSuccess) && (errno & ERR IPC ABORT)) 


EVB_LEDControl (LED1, LED ON); 
} 


/*_ LED 


40. 
放生 庆 必 全 号 量 ， 如 果 阻 塞 被 强制 解除 则 熄灭 LED */ 
和 


42. 
43. 


state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
if ((state != eSuccess) && (errno & ERR IPC ABORT)) 
{ 


44. EVB LEDControl (LED1, LED OFF); 
45. } I 本 

46. } 

47. } 

48. 

49 . 人 

主 控 线 程 的 主 函数 */ 

static void ThreaqCTRLEntry (void* pArg) 

{ 














TErrno errno; 
while (eTrue) 


{ 


主 控 线程 延 时 1 
秒 后 强制 解除 LED 
线程 的 阻塞 */ 
56. TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 

Ts TclAbortSemaphore (&LedSemaphore, &ThreadLED，&errno) 
58 . } 

58。 } 

60 . 

61. 


62 . 六 

用 户 应 用 程序 入 口 函数 */ 

63. static void APP LEDENtry (void) 
64. 

&5。 TErrno errno; 

66. pe 

配置 使 能 评估 板 上 的 LED 

设备 */ 

67. EVB LEDConfig(); 
68. 
69. 
初始 化 信号 量 */ 
10. TclInitSemaphore (&LedSemaphore, 0, 1, IPC PROP NONE, &errno); 





四 





了 
72 . 

初始 化 LED 

设备 控制 线程 */ 

13: TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
74. ThreadLEDStack，THREAD LED STACK SIZE, 
3 THREAD LED PRIORITY, THREAD LED SLICE); 
76. 
3 We 

初始 化 CTRL 

线程 */ 

78. TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
3 ThreadCTRLStack, THREAD CTRL STACK SIZE, 

80 . THREAD CTRL PRIORITY, THREAD CTRL SLICE) 
81. 

82 . 

激活 LED 

线程 */ 

83. TclActivateThread (&ThreadLED); 

84. 











85 . ke 
激活 主 控 线程 */ 
86 TclActivateThread (&ThreadCTRL) ; 





87. } 

88 . 

9 Ls 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提 供 */ 

90 . int main (void) 

91。 

92, 

注册 处 理 器 初始 化 函数 到 内 核 */ 

$3 TclSetCpuEntry (&CPU_STM32F10xInit); 
94. 

95, 

注册 板 级 初始 化 函数 到 内 核 */ 

$6 TclSetBoardEentry (&EVB_ SetupBoard); 
97. 

98 . 是 

注册 板 级 调试 打印 函数 到 内 核 */ 

99 。 TclSetTraceRoutine (&EVB_Uart1WNriteString) 7 
100 . 

101 Ry 





注册 用 户 初始 化 函数 到 内 核 */ 


102 TclSetUserEntry (&APP LEDENtry); 
103 

104. A 

启动 内 核 */ 

105. TclStartKernel (); 
106. 

107, Teturn LT 

108. } 

109, 

110. 

111. #endif 








程序 运行 后 ，LED 的 变化 如 图 4-22 所 示 。 











LED ON 
EDOEE 


ei 





Es 
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一 一 一 一 中 一 一 一 一 一 一 一 一 一 一 一 = 









一 一 一 一 一 一 一 小 一 一 一 一 一 一 一 一 小 一 一 一 一 一 一 一 一 一 一 一 一 一 一 上 一 一 一 一 一 一 一 一 小 一 一 一 一 一 一 一 一 省 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 = 


mm 一 一 一 一 一 一 一 一 


ON ; OFF 


-4+-------- 














4-22 LED 的 变化 情况 





4.3.7 ”信号 量 取消 初始 化 





在 本 例 中 ， 两 个 线程 通过 信号 量 的 操作 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭。 其 中 LED 线 程 首 先 以 阻塞 方式 尝试 获取 信号 量 ， 如 果 LED 线 程 被 解除 在 信号 量 上 的 阻塞 则 点 亮 LED;， 然后 再 次 以 阻塞 方式 尝 
试 获 取信 号 量 ， 如 果 LED 线 程 再 被 解除 阻塞 则 熄灭 LED， 主 控 线程 首先 延 时 1 秒 后， 然后 强制 解除 LED 线 程 的 阻塞 ; 循环 往复 。 程 序 实现 如 代码 清单 4-16 所 示 。 


代码 清单 4-16: 信号 量 应 用 例 程 7 








Ls #include "example.h" 

六 #inclugde "trochili.h" 

: 

4. #if (EVB EXAMPLE 一 CH4 SEMAPHORE EXAMPLE7) 
3 

6 /x 

用 户 线程 参数 */ 

Rs #define THREAD LED STACK SIZE (256) 

生 。 #define THREAD LED PRIORITY {5) 

Ss #define THREAD LED SLICE (20) 
10. 

ds #define THREAD CTRL STACK SIZE (256) 
了 #define THREAD CTRL PRIORITY (4) 

13. #define THREAD CTRL SLICE (20) 
14. 

15. 

用 户 线程 栈 定义 */ 

16; static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
本 static TWord ThreadCTRLStack [THREAD CTRL STACK SIZE]; 
6 

19, 

用 户 线程 定义 */ 

20: static TThread ThreadLED; 

说 3。 static TThread ThreadCTRL;7 

2 

23。 

用 户 信号 量 定义 */ 

24. static TSemaphore LedSemaphore; 

25s 

26. /* LED 

线程 的 主 函 数 */ 

2 static void ThreaqLEDEntry (void* pArg) 
28. { 

295 TErrno errno; 

30 TState state; 

31. 

32。 while (eTrue) 

33. { 


34. /*_ LED 
线程 以 阻塞 方式 获取 信号 量 ， 如 果 信 号 量 被 重 置 则 点 亮 LED */ 
3 state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 


36. if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 
37. { 

38. EVB_LEDControl (LED1, LED ON); 

39; } 

40. 

41. /*_ LED 

线程 以 阻塞 方式 获取 信号 量 ， 如 果 信号 量 被 重 置 则 熄灭 LED */ 

42. state = TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
43. if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 
44. 

45. EVB_LEDControl (LED1, LED OFF); 

46. } 

47. } 

48 . } 

49. 


50 . 

主 控 线程 的 主 函数 */ 

static void ThreadCTRLEnNtry (void* pArg) 
{ 














TErrno errno; 
while (eTrue) 


{ 





主 控 线程 延 时 1 

置信 号 量 */ 

Ss TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 

58. TclDeintSemaphore (&LedSemaphore, &errno); 

S39 TclInitSemaphore (&LedSemaphore, 0, 1, IPC PROP NONE, &errno); 








64. 

用 户 应 用 入 口 函 数 */ 

65. static void APP LEDENtry (void) 
66. { 

Hs TErrno errno; 

68. 


69, 

配置 使 能 评估 板 上 的 LED 

设备 */ 

70% EVB_LEDConfig(); 

Ts 

72: TclInitSemaphore (&LedSemaphore, 0, 1, IPC PROP NONE, &errno); 

33 

74. Vs 

初始 化 LED 

设备 控制 线程 */ 

75 TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 

76. ThreadLEDStack, THREAD LED STACK SIZE, 

了 THREAD LED PRIORITY, THREAD LED SLICE); 

78 

2 ps 

初始 化 CTRL 

线程 */ 

80. TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
ThreadCTRLStack, THREAD CTRL STACK SIZE, 
THREAD CTRL PRIORITY, THREAD CTRL SLICE); 


J 


TclActivateThread (&ThreadLED); 


/六 
主 控 线程 */ 
TclActivateThread (&ThreadCTRL); 








91. A 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提 供 * 

92 int main (void) 
93。 { 


94 . i 

注册 处 理 器 初始 化 函数 到 内 核 */ 

95: TclSetCpuEntry (&CPU_STM32F10xInit); 
96. 


97s 

注册 板 级 初始 化 函数 到 内 核 */ 

98. TclSetBoardEentry (&EVB_SetupBoard); 
99。 


100 . Es 

注册 板 级 调试 打印 函数 到 内 核 */ 

Ts TclSetTraceRoutine (&EVB UartlWritestring); 
102. 

103. iy 

注册 用 户 初始 化 函数 到 内 核 */ 

104. TclSetUserEntry (&APP LEDENtry); 

106- /* 

启动 内 核 */ 
107 。 

108 . 

109, return 1; 
10 } 


Ts 
二] 下。 #endif 


TclstartKernel (); 








程序 运行 后 ，LED 的 变化 如 图 4-23 所 示 。 














一 一 一 一 咎 一 一 一 一 各 二 二 一 一 中 一 一 一 一 中 一 一 一 一 条 一 一 一 一 一 一 一 一 一 一 一 = 





一 二 一 小 一 一 一 一 个 一 一 一 一 小 一 一 一 一 小 一 一 一 一 一 一 一 一 一 一 一 = 





一 一 一 一 上 一 一 一 一 量 志 二 二 二 中 一 一 一 一 中 一 一 一 一 直 一 一 一 一 一 一 一 一 一 一 一 = 





Ts /| 





一 一 一 一 十 一 一 一 一 十 一 一 一 一 中 一 一 一 一 十 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 - 





Ep 





下 





一 一 一 一 十 一 一 一 一 后 一 一 一 一 十 一 一 一 一 十 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 - 
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第 5 章 ” 互 斥 量 设计 实现 


互 斥 量 是 内 核 提供 的 用 于 任务 间 互 斥 运行 的 基本 功能 。 当 某 个 任务 执行 某 关键 代码 时 ， 其 他 任务 不 得 执行 相同 的 操作 ， 主 要 用 于 对 资源 的 互 斥 保护 。 本 章 主 要 介绍 互 斥 量 的 概念 、 设 计 实 现 和 典型 的 使 


5.1， 互 斥 量 基础 知识 


5.1.1 ， 互 斥 量 的 概念 

















互 斥 量 主要 用 于 线程 互 斥 访问 资源 的 目的 ， 它 有 很 多 特性 。 











1. 互 斥 量 所 有 权 





首先 ， 互 斥 量 支 持 所 有 权 的 概念 ， 当 一 个 任务 获得 某 个 互 斥 量 之 后 ， 除 非 它 主动 释放 该 互 斥 量 ， 否 则 别 的 任务 绝对 不 可 能 获得 该 互 斥 量 ， 更 不 能 释放 该 互 斥 量 。 其 次 ， 互 斥 量 支持 递归 访问 。 互 斥 量 会 
记录 自己 被 锁定 的 次 数 ， 也 就 是 锁定 的 深度 ， 因 此 当 占 用 互 斥 量 的 任务 再 次 锁定 互 斥 量 时 不 会 阻塞 在 该 豆 斥 量 上 。 另 外 ， 互 斥 量 还 会 引起 优先 级 翻转 的 问题 ， 关 于 优先 级 翻转 以 及 优先 级 继承 协议 和 优先 级 
天 人 花 板 协议 的 分 析 可 以 参考 前 面相 关 的 章节 。 
































2. 互 斥 量 状 态 





互 斥 量 有 两 种 状态 : LOCKED 和 UNLOCKED， 分 别 代表 开锁 和 闭锁 两 种 情况 ， 因 为 互 斥 量 支持 所 有 者 的 概念 ， 所 以 在 互 斥 量 初始 化 时 ， 应 该 是 开锁 状态 。 互 斥 量 的 状态 迁移 如 图 5-1 所 示 。 




















初始 化 


图 5-1 


3. 任务 阻塞 队列 








互 斥 量具 有 任务 阻塞 的 能 力 ， 与 其 他 两 种 信号 量 不 同 的 是 它 只 拥有 一 个 任务 阻塞 队列 ， 


全 


释放 释放 
( Nest--) ( Nest--) 


获得 获得 
(Nest++ ) (Nest++ ) 


互 斥 信号 量 状 态 迁 移 





























于 保存 那些 对 互 斥 量 加 锁 失败 的 任务 。 








当 互 斥 量 处 于 闭锁 状态 时 ， 如 果 有 任务 来 对 互 斥 量 加 锁 ， 并 且 该 任务 并 不 是 互 斥 量 的 占有 者 ， 那 么 它 或 者 直接 返回 失败 ， 或 者 阻塞 到 该 消息 队列 上 ， 直 到 互 斥 量 解锁 或 者 阻塞 时 限 到 达 ; 因为 只 有 拥有 
互 斥 量 的 任务 才能 解锁 互 斥 量 ， 所 以 对 互 斥 量 的 解锁 操作 不 会 导致 任务 阻塞 ， 要 么 成 功 ， 要 么 失败 。 另 外 ，1SR 不 能 对 互 斥 量 进行 加 锁 或 解锁 操作 。 


5.1， 互 斥 量 基础 知识 


5.1.1 ， 互 斥 量 的 概念 

















互 斥 量 主要 用 于 线程 互 斥 访问 资源 的 目的 ， 它 有 很 多 特性 。 





1. 互 斥 量 所 有 权 

















首先 ， 互 斥 量 支 持 所 有 权 的 概念 ， 当 一 个 任务 获得 某 个 互 斥 量 之 后 ， 除 非 它 主动 释放 该 互 斥 量 ， 否 则 别 的 任务 绝对 不 可 能 获得 该 互 斥 量 ， 更 不 能 释放 该 互 斥 量 。 其 次 ， 互 斥 量 支持 递归 访问 。 互 斥 量 会 
记录 自己 被 锁定 的 次 数 ， 也 就 是 锁定 的 深度 ， 因 此 当 占 用 互 斥 量 的 任务 再 次 锁定 互 斥 量 时 不 会 阻塞 在 该 豆 斥 量 上 。 另 外 ， 互 斥 量 还 会 引起 优先 级 翻转 的 问题 ， 关 于 优先 级 翻转 以 及 优先 级 继承 协议 和 优先 级 






































天 花 板 协议 的 分 析 可 以 参考 前 面相 关 的 章节 。 


2. 互 斥 量 状态 





互 斥 量 有 两 种 状态 : LOCKED 和 UNLOCKED， 分 别 代表 开锁 和 闭锁 两 种 情况 ， 因 为 互 斥 量 支持 所 有 者 的 概念 ， 所 以 在 互 斥 量 初始 化 时 ， 应 该 是 开锁 状态 。 互 斥 量 的 状态 迁移 如 图 5-1 所 示 。 




















释放 
( Nest--) 


初始 化 


获得 


(Nest+H+ ) 





图 5-1 互 斥 信 号 量 状态 迁移 











3. 任务 阻塞 队列 


























互 斥 量具 有 任务 阻塞 的 能 力 ， 与 其 他 两 种 信号 量 不 同 的 是 它 只 拥有 一 个 任务 阻塞 队列 ， 用 于 保存 那些 对 互 斥 量 加 锁 失败 的 任务 。 








丢 放 
(Nest-- ) 


获得 


( Nest++) 





当 互 斥 量 处 于 闭锁 状态 时 ， 如 果 有 任务 来 对 互 斥 量 加 锁 ， 并 且 该 任务 并 不 是 互 斥 量 的 占有 者 ， 那 么 它 或 者 直接 返回 失败 ， 或 者 阻塞 到 该 消息 队列 上 ， 直 到 互 斥 量 解锁 或 者 阻塞 时 限 到 达 ; 因为 只 有 拥有 





互 斥 量 的 任务 才能 解锁 互 斥 量 ， 所 以 对 互 斥 量 的 解锁 操作 不 会 导致 任务 阻塞 ， 要 么 成 功 ， 要 么 失败 。 另 外 ，1SR 不 能 对 互 


5.1.2， 互 斥 量 的 操作 


常见 的 互 斥 量 的 操作 如 表 5-1 所 示 。 


表 5-1 互 斥 量 常见 操作 





斥 量 进行 加 锁 或 解锁 操作 。 


5 ET Em 


DT 
; ET 
RD 





(1) Create 互 斥 量 创建 





功能 
对 互 斥 量 解锁 
互 斥 量程 阻塞 队列 的 刷新 


互 太 量 查询 


创建 互 斥 量 时 ， 用 户 可 以 指定 互 斥 量 的 各 种 参数 属性 。 比 如 针对 多 个 任务 在 互 斥 量 上 的 阻塞 和 调度 方式 : 既 可 以 配置 成 FIFO 方 式 来 处 理 ， 也 可 以 按照 任务 优先 级 来 处 理 。 


(2) Delete 互 斥 量 删除 


删除 互 斥 量 时 ， 需 要 把 所 有 阻塞 在 互 斥 量 上 的 任务 解除 阻塞 ， 互 斥 量 一 旦 被 删除 ， 就 不 能 再 次 操作 了 。 另 外 当 互 斥 量 被 菜 个 任务 占用 时 ， 如 采用 户 需 要 删除 该 任务 则 需要 保证 同步 处 理 互 斥 量 ， 否 则 会 


时 致 该 互 斥 量 无 法 被 释放 。 


(3) Lock 对 互 斥 量 加 锁 


如 果 互 斥 量 的 状态 为 开锁 ， 则 当前 任务 可 以 直接 锁定 互 斥 量 ; 如 果 互 斥 量 被 当前 任务 锁定 ， 那 么 当前 任务 也 可 以 对 互 斥 量 进行 递归 锁定 ; 如 果 互 斥 量 被 其 他 任务 锁定 ， 则 当前 任务 直接 返回 ， 或 者 阻塞 


在 互 斥 量 的 任务 阻塞 队列 中 ， 如 果 需 要 ， 此 时 还 可 以 进行 优先 级 继承 协议 的 操作 。 


(4) Unlock 对 互 斥 量 解 锁 


如 果 互 斥 量 并 没有 被 当前 任务 占用 ， 则 当前 任务 直接 返回 失败 。 只 有 互 斥 量 确实 是 被 当前 任务 占用 ， 那 么 任务 才 可 以 对 互 斥 量 进行 解锁 操作 。 因 为 互 斥 量 支 持 递 归 锁 定 的 特点 ， 所 以 一 次 解锁 操作 未 必 
能 真正 解锁 互 斥 量 ， 当 前 任务 可 能 仍然 占用 互 斥 量 。 当 任务 真正 解锁 互 斥 量 时 ， 需 要 进一步 检查 互 斥 量 的 任务 阻塞 队列 上 是 否 有 任务 因为 无 法 锁定 互 斥 量 而 阻塞 。 如 果 有 ， 则 需要 唤醒 其 中 的 菜 个 任务 并 使 


得 它 占用 互 斥 量 。 


(5) Flush 互 斥 量 阻 塞 队 列 的 刷新 


当 有 多 个 任务 因为 不 能 占有 互 斥 量 而 阻塞 时 ， 用 户 可 以 通过 Flush 操 作 同 时 将 这 些 任务 解除 阻塞 ， 完 成 多 任务 的 同步 。 


(6) Query 互 斥 量 查询 


应 用 程序 可 以 随时 查看 某 个 互 斥 量 的 当前 状态 ， 将 互 斥 量 的 数据 结构 复制 后 分 析 使 用 。 但 需要 注意 因为 复制 出 来 的 数据 只 是 系统 某 个 时 刻 的 情况 ， 所 以 需要 用 户 封 酌 使 用 


5.1.3” 互 斥 量 的 应 用 








在 实际 运行 的 系统 当中 ， 互 斥 


























要 用 于 任务 间 的 资源 共享 ， 而 不 是 用 于 任务 间 的 同步 或 者 任务 /IlSR 的 同步 。 读 者 一 定 要 记 住 ， 对 于 互 斥 量 来 说 ， 它 永远 不 能 被 |SR 访 问 。 
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5-2 为 多 个 任务 间 通 过 互 斥 量 来 互 斥 访问 共享 资源 。 
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互 斥 信号 最 


图 5-2 互 斥 量 用 于 多 任务 互 斥 











在 图 5-2 中 ， 三 个 任务 都 要 访问 共享 
的 是 ， 因 为 互 斥 量 支 持 所 有 者 概念 ， 所 以 当 其 中 一 个 任务 得 到 互 斥 量 后 ,其 











资源 ， 但 是 在 任务 和 资源 之 间 有 互 斥 信号 量 作为 互 斥 保护 。 当 任务 需要 访问 资源 时 ， 必 须 首 先 得 到 互 斥 量 ， 不 能 直接 操作 资源 。 和 二 值 信号 量 对 资源 的 互 斥 保护 不 同 
他 任务 不 可 能 解锁 互 斥 量 ， 也 就 无 法 得 到 互 斥 量 ， 无 法 访问 资源 。 





























当 任务 访问 共享 资源 时 ， 有 可 能 因为 多 次 调用 某 个 访问 资源 的 函数 而 重复 调用 互 斥 量 的 锁定 函数 ， 不 过 正 | 
连续 两 次 获取 二 值 信号 量 而 把 自己 阻塞 ， 进 而 造成 死 锁 。 
































为 互 斥 量 支 持 重 复 锁定 ， 所 以 不 会 有 问题 。 假 如 是 二 值 信号 量 ， 那 么 就 不 同 了 ， 任 务 会 因为 














图 5-3 为 任务 通过 互 斥 量 庶 套 访问 共享 资源 。 





图 5-3 互 斥 量 用 于 递归 互 斥 












































在 图 5-3 中 ， 任 务 A 可 能 直接 访问 互 斥 量 ， 也 有 可 能 通过 调用 函数 A 或 者 函数 B 访 问 互 斥 量 ， 而 函数 A 也 有 可 能 通过 函数 B 访 问 互 斥 量 。 在 复杂 
易 出 现 图 5-3 所 示 的 情况 。 因 为 互 斥 量 支持 任务 递归 锁定 功能 ， 所 以 这 样 使 





的 系统 中 ， 对 互 斥 量 访问 函数 的 调用 关系 可 能 比较 复杂 ， 容 
用 起 来 是 安全 的 。 任 务 通过 互 斥 量 庶 套 访问 共享 资源 的 代码 如 代码 清单 5-1 所 示 。 











代码 清单 5-1: 互 斥 量 用 于 资源 保护 演示 





14. void TaskAccessResource (void) 

15。 

16. http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 
Ly Lock Mutex; 

TS。 Access Resource; 

了 Unlock Mutex; 

20. 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 
21. } 





5.2，” 互 斥 量 设计 实 现 





Trochili RTOS 支 持 互 斥 量 。 互 斥 量 控制 结构 定义 在 mutex.h 文 件 中 ， 其 结构 如 代码 清单 5-2 所 示 。 





代码 清单 5-2: 互 斥 量 结构 定义 





六 


下。 

互 斥 信号 量 结构 定义 */ 

2 struct MutexDef 

3. { 

4. TProperty Property; /* 
队列 中 线程 的 调度 策略 等 属性 配置 */ 

和 TWord Nest; Ea 
互 斥 信号 量 嵌 套 加 锁 深 度 。 */ 

6. TThread* Holder; Ve 
占有 互 斥 信 避 是 的 /和 指针 */ 

pcQueue Queue; /* 
互 斥 信 各 租 染 队 界 

8 

8 te struct MutexDef TMutex; 





“ Property: 互 斥 量 支持 不 同 的 线程 调度 策略 ， 由 成 员 Property 的 相应 比特 位 决定 。 互 斥 量 支持 两 种 线程 排队 的 方式 ， 即 FIFO 方 式 和 基于 线程 优先 级 的 排队 方式 。 
“ Nest: 记录 了 互 斥 量 被 某 个 线程 重复 锁定 的 次 数 ， 也 就 是 锁定 深度 。 

:Queue: 互 斥 量 拥有 一 个 线程 阻塞 队列 ， 用 于 保存 那些 因 无 法 获得 互 斥 量 而 需要 被 阻塞 的 线程 。 

“ Holder: 记录 了 互 斥 量 当前 的 所 有 者 ， 即 某 个 线程 的 地 址 。 

当前 Trochili RTOS 实 现 的 互 斥 量 操作 函数 主要 有 以 下 几 种 : 


“ 互 斥 量 初始 化 〈Init) : 目前 Trochili RTOS 提 供 的 API 不 支持 动态 创建 和 删除 互 斥 量 ， 需 要 用 户 提前 准备 一 个 互 斥 量 结构 ， 然 后 作为 参数 被 API 初 始 化 。 





: 互 斥 量 取消 初始 化 (Reinit) : 将 互 斥 量 恢复 到 初始 状态 ， 与 互 斥 量 初始 化 的 功能 是 相反 的 。 互 斥 量 被 取消 初始 化 之 后 ， 如 果 还 想 使 用 它 ， 则 需要 再 次 初始 化 。 

“ 互 斥 量 释放 (Free) : 线程 尝试 将 已 经 锁定 的 互 斥 量 释 放 。 因 为 线程 只 能 释放 自己 占用 的 互 斥 量 ， 所 以 这 个 操作 不 会 把 线程 阻塞 。 操 作 要 么 成 功 ， 要 么 失败 ， 直 接 返回 结果 。 

“ 互 斥 量 获 取 (Lock) : 线程 尝试 锁定 已 经 初始 化 后 的 互 斥 量 。 如 果 互 斥 量 已 经 被 别 的 线程 获得 则 操作 失败 。 根 据 操作 模式 ， 线 程 或 者 直接 返回 或 者 阻塞 在 互 斥 量 的 线程 阻塞 队列 上 。 

“ 互 斥 量 刷 新 (Flush) : 将 互 斥 量 上 的 所 有 阻塞 线程 唤醒 ， 并 且 设置 互 斥 量 所 有 者 为 空 。 

“ 线程 阻塞 终止 (Abort) : 将 阻塞 在 互 斥 量 线程 阻塞 队列 上 的 线程 解除 阻塞 。 

“ 互 斥 量 查询 (Query) : 将 互 斥 量 结构 的 数据 完整 地 复制 到 指定 的 结构 中 ， 保 存 互 斥 量 数据 的 快照 。 注 意 因为 系统 运行 时 互 斥 量 随时 可 能 被 操作 ， 所 以 查询 出 来 的 数据 可 能 不 是 最 新 的 。 
对 互 斥 量 功能 函数 的 总 结 见 表 5-2。 


表 5-2 互 斥 量 功 能 函数 


DT 
; TT 加 





4 TclFreeMutex 不 支持 
6 TclAbortMutex 支持 
可 


5.2.1 互 斥 量 的 初始 化 








调用 互 斥 量 初始 化 函数 时 可 以 将 互 斥 量 状态 置 为 就 绪 。 该 函数 的 主要 步骤 是 : 








“ 设置 互 斥 量 属性 为 就 绪 
“ 设置 互 斥 量 所 有 者 为 空 
“ 设置 互 斥 量 锁 定 深度 为 0 


“ 初始 化 互 斥 量 线程 阻塞 队列 


5.2.2 互 斥 量 取消 初始 化 


互 斥 量 取消 初始 化 和 互 斥 量 初始 化 是 相反 的 操作 。 它 会 对 互 斥 量 做 如 下 操作 : 
“ 重新 设置 成 非 初始 化 状态 

“ 设置 互 斥 量 所 有 者 为 空 

' 设置 互 斥 量 锁定 深度 为 0 

“ 初始 化 互 斥 量 线程 阻塞 队列 

: 释放 所 有 阻塞 在 互 斥 量 上 的 线程 


该 函数 的 流程 图 如 图 5-4 所 示 。 





2 内 核 进 入 独占 区 


4 重 置 互 斥 量 所 有 者 为 空 ; 


设置 互 不 量 缩 地 深度 为 空 ; 
设置 属性 为 空 






5 有 上 比 当前 线程 优先 级 
高 的 线程 解除 阻塞? 





流程 图 











STEP2 


STEP3 


STEP4 


STEP5 


STEP6 


STEP7 


STEP8 


STEPY 


6 内 核 多 许 线 程 调度 ? 







7 质数 被 线程 调用 ? 


9 内 核 退 出 独占 区 








图 5-4 互 斥 量 取 消 初 始 化 流程 图 


分 析 : 


内 核 进入 临界 区 。 


首先 将 互 斥 量 的 线程 阻塞 队列 清空 ， 唤 醒 全 部 被 阻塞 的 线程 。 


取消 初始 化 互 斥 量 的 所 有 者 为 空 ; 锁定 深度 为 0; 取消 互 斥 量 的 就 绪 属 性 。 


判断 在 清空 互 斥 量 的 线程 阻塞 队列 时 是 否 唤 醒 了 比 当 前 线程 优先 级 高 的 线程 。 


如 果 是 ， 则 判断 内 核 是 不 是 允许 线程 调度 。 


如 果 是 ， 则 判断 该 函数 是 否 被 线程 调用 。 


如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 


内 核 退 出 独占 区 ， 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线 程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP10 ”函数 返回 。 


5.2.3” 互 斥 量 的 加 锁 


互 斥 量 的 加 锁 操作 主要 是 由 以 下 几 个 函数 来 完成 的 。 


. 互 斥 


量 获取 操作 的 接口 函数 xMutexLock () : 该 函数 是 互 斥 量 模块 向 外 提供 的 接口 函数 ， 被 内 核 API 函 数 调用 。 由 该 函数 完成 和 互 斥 量 相关 的 内 核 数 据 的 保护 工作 。 


“ 线程 获取 互 斥 量 函 数 LockMutex () : 该 函数 实现 了 线程 访问 互 斥 量 的 核心 逻辑 。 它 会 首先 通过 函数 TryLockMutex () 尝试 对 互 斥 量 加 锁 ， 然 后 根据 结果 来 继续 操作 。 


“ 尝试 获取 互 斥 量 函 数 TryLockMutex () : 这 个 函数 是 获取 互 斥 量 的 核心 部 分 ， 它 会 根据 互 斥 量 当 前 状态 来 处 理 本 次 请 求 。 


“ 如 果 互 斥 量 没有 被 别 的 线程 锁定 则 锁定 该 互 斥 量 ; 设置 互 斥 量 所 有 者 为 当前 线程 ， 互 斥 量 锁定 深度 为 1。 


“ 如 果 互 斥 量 已 经 被 自己 锁定 则 将 该 互 斥 量 的 锁定 深度 加 1。 


“ 如 果 互 斥 量 已 经 被 别 的 线程 锁定 ， 则 尝试 实施 优先 级 继承 算法 。 





这 几 个 函数 的 层次 关系 比较 简单 。 注 意 xMutexLock () 起 到 的 是 分 发 调用 的 作用 ， 函 数 LockMutex () 是 线程 环境 下 的 具体 操作 函数 ， 而 TryLockMutex () 则 主要 是 操作 互 斥 量 对 象 。 这 几 个 函数 
的 流程 图 如 图 5-5 至 图 5-7 所 示 。 




















1. 互 斥 量 加 锁 接口 函数 


互 斥 量 加 锁 接口 函数 的 流程 图 如 图 5-5 所 示 。 











6 保存 互 斥 量 操作 信息 挂 起 当前 线程 


2 尝试 获 取 互 斥 量 





8 内 核 退 出 独占 区 
线程 阻塞 阶段 


10 读 取 互 斥 量 操作 结果 


清除 互 不 量 操作 信息 











5-5 ” 互 斥 量 加 锁 接口 子 数 流程 

















流程 图 分 析 : 

STEP2 ”当前 线程 尝试 获取 互 斥 量 。 

STEP3 判断 本 次 获取 互 斥 量 操作 是 否 成 功 。 

STEP4 如 果 没 有 成 功 ， 则 需要 检查 本 次 操作 是 不 是 阻塞 模式 。 

STEP5 如 果 是 ， 则 判断 内 核 是 不 是 允许 线程 调度 。 

STEP6 如 果 是 ， 则 此 时 需要 保存 本 次 操作 的 信息 到 IPC 缓 存 ， 并 将 当前 线程 阻塞 在 互 斥 量 的 线程 阻塞 队列 。 
STEP7 向 内 核发 出 线程 调度 请 求 。 

STEP8 内 核 退 出 独占 区 ， 当 前 线程 被 阻塞 ， 直 到 被 再 次 唤醒 。 

STEP9 ”线程 被 唤醒 并 且 调 度 执 行 ， 在 这 里 立刻 使 得 内 核 进 入 独占 区 。 

STEP10 读 取 本 次 互 斥 量 获取 操作 的 结果 ， 随 后 清空 当前 线程 的 IPC 的 缓存 信息 。 


STEP11 ”函数 返回 。 











从 图 5-5 中 可 以 看 出 ， 在 线程 获取 互 斥 量 时 ， 首 先是 尝试 一 下 ， 在 尝试 的 过 程 中 可 能 成 功 也 可 能 失败 。 失 败 了 可 能 需要 把 自己 阻塞 ;在 成 功 的 时 候 ， 和 信号 量 不 同 ， 不 会 唤醒 阻塞 在 互 斥 量 上 的 线程 ， 因 
为 线程 不 会 因为 无 法 释放 互 斥 量 而 阻塞 。 








2. 线程 获取 互 斥 量 函 数 





线程 获取 互 斥 量 函 数 流程 图 如 图 5-6 所 示 。 











流程 图 分 析 : 


STEP2 ”当前 线程 尝试 获取 互 斥 量 。 


STEP3 判断 本 次 获取 互 斥 量 操作 是 否 成 功 。 









6 保存 互 斥 量 操作 信息 挂 起 当前 线程 





2 尝试 获取 互 不 量 


8 内 核 退 出 独占 区 


线程 阻塞 阶段 


Y 
9 内 核 进 入 独占 区 








10 读 取 互 斥 量 操作 结果 
清除 互 斥 量 操作 信息 











5-6 ”线程 获取 互 斥 量 函 数 流程 

















STEP4 如 果 没有 成 功 ， 则 需要 检查 本 次 操作 是 不 是 阻塞 模式 。 

STEP5 如 果 是 ， 则 判断 内 核 是 不 是 允许 线程 调度 。 

STEP6 如 果 是 ， 则 此 时 需要 保存 本 次 操作 的 信息 到 IPC 缓 存 ， 并 将 当前 线程 阻塞 在 互 斥 量 的 线程 阻塞 队列 。 
STEP7 向 内 核发 出 线程 调度 请 求 。 

STEP8 内 核 退 出 独占 区 ， 当 前 线程 被 阻塞 ， 直 到 被 再 次 唤醒 。 

STEP9 线程 被 唤醒 并 且 调度 执行 ， 在 这 里 立刻 使 得 内 核 进入 独占 区 。 

STEP10 读 取 本 次 互 斥 量 获取 操作 的 结果 ， 随 后 清空 当前 线程 的 IPC 的 缓存 信息 。 


STEP11 ”函数 返回 。 








从 图 5-6 中 可 以 看 出 ， 在 线程 获取 互 斥 量 时 ， 首 先是 尝试 一 下 ， 在 尝试 的 过 程 中 可 能 成 功 也 可 能 失败 。 失 败 了 可 能 需要 把 自己 阻塞 ; 在 成 功 的 时 候 ， 与 信和 号 量 不 同 ， 不 会 唤醒 阻塞 在 互 斥 量 上 的 线程 ， 
为 线程 不 会 因为 无 法 释放 互 斥 量 而 阻塞 。 











3. 尝试 获取 互 斥 量 函 数 


尝试 获取 互 斥 量 函 数 流程 图 如 图 5-7 所 示 。 











流程 图 分 析 : 


STEP2 检查 互 斥 量 是 否 已 经 被 占用 。 


STEP3 ”如果 被 占用 ， 则 进一步 检查 互 斥 量 是 不 是 被 当前 线程 占用 。 


STEP4 如 果 互 斥 量 被 其 他 线程 占用 ， 则 判断 当前 线程 的 优先 级 是 否 高 于 占用 互 斥 量 的 线程 。 


STEP5 如 果 是 ， 则 实施 优先 级 继承 协议 ， 修 改 〈 提 升 ) 占用 互 斥 量 的 线程 的 优先 级 。 


1 开始 


2 互 斥 量 未 被 占用 ? 


在 


互 厂 量 被 当前 线程 占用 ? 











图 5-7 ”尝试 获取 互 斥 量 函数 流程 图 








STEP6 如 果 互 斥 量 没有 被 占用 ， 则 使 得 当前 线程 占用 互 斥 量 。 
STEP7 如 果 互 斥 量 被 当前 线程 占用 ， 则 使 得 当前 线程 谋 套 占用 互 斥 量 。 


STEP8 函数 返回 。 


5.2.4， 互 斥 量 的 释放 


互 斥 量 的 释放 操作 主要 是 由 以 下 几 个 函数 来 完成 的 。 


“ 互 斥 量 释放 接口 函数 xMutexFree () : 该 函数 是 互 斥 量 模块 向 外 提供 的 接口 函数 ， 被 内 核 API 函 数 调用 。 因 为 只 有 占用 互 斥 量 的 线程 才能 释放 互 斥 量 ， 所 以 这 个 函数 不 像 信号 量 释放 流程 那样 复杂 。 男 
外 由 该 函数 完成 和 互 斥 量 相关 的 内 核 数 据 的 保护 工作 。 


“ 线程 释放 互 斥 量 函数 FreeMutex () : 该 函数 实现 了 线程 访问 互 斥 量 的 核心 逻辑 。 
“ 如 果 互 斥 量 没有 被 当前 线程 占用 ， 则 直接 返回 。 
“ 如 果 互 斥 量 被 当前 线程 占用 ， 则 将 互 斥 量 的 庶 套 锁定 深度 减 1。 
“ 如 果 互 斥 量 的 庶 套 锁定 深度 为 0)， 则 必须 释放 互 斥 量 。 
“ 在 释放 互 斥 量 时 检查 互 斥 量 的 线程 阻塞 队列 中 是 否 存 在 线程 ， 如 果 存在 ， 则 将 互 斥 量 交 给 其 中 的 某 个 线程 ; 如 果 没 有 ， 则 设置 互 斥 量 未 被 占用 。 


:处理 优先 级 反 转 问题 。 
1. 释放 互 斥 量 接口 函数 


函数 xMutexFree () 非常 简单 ， 只 是 直接 调用 函数 FreeMutex () ， 保 留 这 样 的 函数 是 出 于 保持 代码 层次 的 需要 。 





2. 线程 释放 互 斥 量 函 数 





线程 释放 互 斥 量 函数 流程 图 如 图 5-8 所 示 。 

















图 5-8 ”线程 释放 互 斥 量 函 数 流程 图 





流程 图 分 析 : 











STEP2 


STEP3 


STEP4 


STEP5 


STEP6 


STEP7 


STEP8 


STEP9 


STEP10 


STEP11 


STEP12 


STEP13 


STEP14 


STEP15 


判断 当前 线程 是 否 占用 互 斥 量 。 


如 果 有 ， 则 将 互 斥 量 锁定 深度 减 1。 


判断 互 斥 量 锁定 深度 是 否 为 0。 


如 果 是 ， 则 继续 判断 当前 线程 是 否 被 实施 了 优先 级 继承 协议 。 


如 果 是 ， 则 恢复 当前 线程 的 原 有 优先 级 。 


判断 此 时 是 否 有 更 高 就 绪 优 先 级 线程 就 绪 。 





如 果 有 ， 则 记录 线程 调度 请 求 标记 。 


演 试 从 互 斥 里 线程 阻塞 队列 中 唤醒 一 个 线程 (如 果 被 唤醒 的 线程 的 优先 级 高 于 当前 线程 优先 级 则 会 记录 线程 调度 请 求 ) 。 


判读 是 否 有 线程 被 唤醒 。 


如 果 有 ， 则 将 互 斥 量 交 给 该 线程 。 


如 果 没 有 ， 则 将 互 斥 量 释放 。 


判断 此 时 内 核 是 否 允 许 线程 调度 并 且 线 程 调度 请 求 标记 释放 为 真 。 


如 果 条 件 满足 ， 则 向 内 核 申 请 线程 调度 。 


从 上 面 的 流程 中 可 以 看 出 ， 在 线程 进行 互 斥 量 的 释放 时 : 


“ 首先 是 检查 互 斥 量 是 否 被 当前 线程 占用 ， 如 果 是 ， 则 将 互 斥 量 的 锁定 深度 减 1; 如 果 锁 定 深度 为 0， 则 说 明 必 须 释 放 该 互 斥 量 了 。 


“ 然后 程序 检查 当前 线程 在 占用 互 斥 量 期 间 是 否 被 实施 了 优先 级 继承 协议 ， 如 果 有 ， 则 要 恢复 当期 线程 的 原 有 优先 级 。 


“ 随后 程序 检查 互 斥 量 的 线程 阻塞 队列 上 是 否 有 线程 被 阻塞 ， 如 果 有 ， 则 唤醒 其 中 一 个 线程 并 且 将 互 斥 量 交 给 该 线程 ; 如 果 没 有 ， 则 将 互 斥 量 彻底 释放 。 


“ 最 后 在 函数 返回 之 前 还 要 检查 是 否 需要 发 起 线程 调度 。 


该 函数 的 伪 代 码 如 代码 清单 5-3 所 示 。 


代码 清单 5-3: 互 斥 量 释放 代码 演示 





a [i en a 
如 “合营 
地 ”号 
品 剖 
各 
过 
高 
2 


bd ded 
nt 


性 


if ( 
量 锁定 深度 为 0) 
{ 


if ( 
i 线程 曾 发 生 过 优先 级 继承 ) 
{ 


0, 
属 复 当前 线 各 的 原 妈 优先 二 ， 
kM 和 
当前 线程 优先 级 不 是 最 高 就 绪 优 先 级 ) 
{ 


3 
记录 六 求全 程 调 度 标记 ; 


5 
区。 


} 


Ts 
尝试 从 互 斥 量 阻塞 队列 中 选择 合适 的 线程 ; 
if ( 


18. 
唤醒 了 某 线程 ) 
19. 


26. 
线程 调度 标记 为 真 ) 


3 


{ 


县 
人 让 有 站 线 可 岗 度 ) 





5.2.5 终 


止 线程 阻塞 


线程 阻塞 在 互 斥 量 的 线程 阻塞 队列 时 ， 可 以 是 无 限期 的 阻塞 直到 对 互 斥 量 的 操作 成 功 ; 或 者 有 期 限 的 等 待 ， 在 期 限 到 达 时 如 果 仍 然 无 法 成 功 ， 则 自动 退出 阻塞 。 这 里 的 终止 互 斥 量 阻 塞 线程 的 操作 则 是 


1 开始 


2 内 核 进 入 独占 区 





由 外 部 强制 解除 线程 阻塞 。 其 流程 图 如 图 5-9 所 示 。 














8 内 核 退 出 独占 区 





图 5-9 ”解除 线程 阻塞 流程 图 


流程 图 分 析 : 


STEP2 内 核 进入 临界 区 。 


STEP3 ”将 线程 从 互 斥 量 的 线程 阻塞 队列 中 解除 阻塞 。 该 函数 会 检查 指定 的 线程 是 否 阻塞 在 互 斥 量 的 线程 阻塞 队列 中 。 


STEP4 判断 被 解除 阻塞 的 线程 的 优先 级 是 否 比 当前 线程 的 优先 级 高 。 





STEP5 判断 此 时 内 核 是 否 允 许 线程 调度 。 

STEP6 如果 是 ， 则 判断 此 时 函数 是 否 被 线程 调用 。 

STEP7 如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 

STEP8 内 核 退 出 独占 区 ， 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP9 函数 返回 。 


5.2.6 互 斥 量 刷 新 


互 斥 量 刷新 和 互 斥 量 取消 初始 化 很 像 ， 不 同 的 地 方 在 于 取消 初始 化 互 斥 量 操作 不 仅 会 清空 互 斥 量 的 线程 阻塞 队列 ， 还 把 互 斥 量 设 置 成 进入 非 初 始 化 状态 。 而 互 斥 量 刷新 则 只 是 将 互 斥 量 线程 阻塞 队列 上 
的 线程 全 部 唤醒 ， 这 样 互 斥 量 就 像 刚 被 初始 化 后 的 情形 ， 可 以 继续 使 用 。 互 斥 量 刷新 流程 图 如 图 5-10 所 示 。 


1 开始 














2 内 核 进入 独占 区 





4 有 比 当 前 线程 优先 弘 
融 的 线程 解除 阻 宪 ? 





8 内 核 退 出 独占 区 





图 5-10 互 斥 量 刷新 流程 图 











流程 图 分 析 : 


STEP2 


STEP3 


STEP4 


STEP5 


STEP6 


STEP7 


STEP8 


STEPY 


内 核 进 入 临界 区 。 

首先 将 互 斥 量 的 线程 阻塞 队列 清空 ， 唤 醒 全 部 被 阻塞 的 线程 。 保 持 互 斥 量 的 就 绪 属 性 。 

在 清空 互 斥 量 的 线程 阻塞 队列 时 可 能 唤醒 了 比 当前 线程 优先 级 高 的 线程 ， 此 处 检查 是 否 需要 进行 线程 调度 。 

判断 该 函数 是 否 被 线程 调用 。 

判断 内 核 是 否 允 许 线程 调度 。 

如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 

内 核 退 出 独占 区 ， 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


函数 返回 。 


5.3， 互 斥 量 应 用 演示 























结合 前 面 介绍 的 互 斥 量 的 使 用 模型 和 Trochili RTOS 的 互 斥 量 设计 实现 ， 我 们 通过 下 面 的 几 个 实际 例 程 来 演示 互 














5.3.1 “线程 间 的 资源 共享 


在 本 例 中 ， 两 个 线程 通过 互 斥 量 的 操作 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭。 其 中 LED 点 亮 线程 则 不 停 地 以 阻塞 方式 尝试 获取 互 斥 量 ， 得 到 互 斥 量 后 点 亮 LED， 延 时 1 秒 后 再 释放 互 扩 量 ;而 LED 熄 灭 线程 

















斥 量 的 使 用 。 我 们 将 通过 不 同 的 互 斥 量 使 用 方式 实现 评估 板 上 的 LED 灯 的 点 亮 和 熄灭 。 


























则 不 停 地 以 阻塞 方式 尝试 获取 互 斥 量 ， 得 到 互 斥 量 后 熄灭 LIED， 延 时 1 秒 后 再 释放 互 斥 量 。 程 序 实现 如 代码 清单 5-4 所 示 。 





代码 清单 5-4: 互 斥 量 应 用 例 程 1 





#include "example.h" 
#include “trochili.h" 


#if (EVB EXAMPLE == CH5 MUTEX FXAMPLE1) 


A 

户 线程 参数 */ 

#define THREAD LED STACK SIZE (256*2) 
#define THREAD LED PRIORITY (5) 
#define THREAD LED SLICE (2000) 


Po. 


2 

户 线程 定义 */ 

static TThread ThreadLEDOnN; 
static TThread ThreadLEDOff; 


ON On 心 W 


学 
月 户 线程 栈 定义 */ 


洒 忆 中 症 河 FRRP 河 RPRPRoo 洒 -aummew 








static TWord ThreadLEDOnStack[THREAD LED STACK SIZE]; 
8. static TWord ThreadLEDOffStack[THREAD LED STACK SIZE]; 
网 

0 
户 互 斥 量 定义 */ 

Es static TMutex LedMutex; 

22. 

23, /* LED 


线程 的 主 函 数 */ 
static void ThreadLEDOnEntry (void* pArg) 
{ 
TErrno errno; 
TState state; 
while (eTrue) 


本 /* LED 

线程 以 阻塞 方式 锁定 互 斥 量 ， 如 果 成 功 则 点 亮 LED */ 

state = TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 
if (state == eSuccess) 


{ 





EVB_LEDControl (LED1, LED ON); 


/* LED 





点 亮 线 程 延 时 1 

秒 */ 
TclDelayThread (&ThreadLEDOn, MLS2TICKS (1000)); 

/* LED 

线程 释放 互 斥 量 */ 


} 


TclFreeMutex (&LedMutex, &errno); 


} 





四 /* LED 

熄灭 线程 的 主 函数 */ 

46. static void ThreadLEDOffEntry (void* pArg) 
47. { 

48. TErrno errno; 

49. TState state; 





Ss while (eTrue) 


53. /* LED 

熄灭 线程 以 阻塞 方式 锁定 互 斥 量 ， 如 果 成 功 则 熄灭 LED */ 

54. state = TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 
55, if (state = eSuccess) 

56. { 

SIs EVB_LEDControl (LED1, LED OFF); 

58 . 

S59. /* LED 

熄灭 线程 延 时 1 

秒 */ 

60. TclDelayThread (&ThreadLEDOff, MLS2TICKS (1000)); 

61. 

62. /* LED 

熄灭 线程 释放 互 斥 量 */ 
63. 


64. } 
65。 } 

66. } 

7 


68. 下 

用 户 应 用 入 口 函数 */ 

69 . static void APP LEDEntry (void) 
70. + 

Ws TErrno errno; 


TclFreeMutex (gLedMutex, &errno); 


/* 
配置 使 能 评估 板 上 的 LED 
答 如 


74. EVB LEDConfig () 7 


初始 化 互 斥 量 */ 
时 这 TclInitMutex(&LedMutex, IPC PROP NONE, &errno) 


79. 

初始 化 LED 

设备 控制 线程 */ 

80. TclInitThread (&ThreadLEDON, &ThreadLEDONENntry, (void*)NULL, 
81. ThreadLEDOnStack，THRERAD LED STACK SIZE, 

82. THREAD LED PRIORITY, THREAD LED SLICE); 


84. 水 
初始 化 LED 
设备 控制 线程 */ 
5 TclInitThread (&ThreadLEDOff, &ThreadLEDOffEntry, (void*)NULL, 
ThreadLEDOffStack, THREAD LED STACK SIZE, 
THREAD LED PRIORITY + 1, THREAD LED SLICE); 





J 


TclActivateThread (&ThreadLEDON); 





/* 


92 . 
激活 LED 


熄灭 线程 */ 
93。 

94 . } 
95, 

96. La 
处 理 器 BOOT 
之 后 会 调用 main 

函数 ， 必 须 提 供 */ 

97 . int main (void) 
98 . { 


99., sy 
注册 处 理 器 初始 化 函数 到 内 核 */ 
100 . TclSetCpuEntry (&CPU_STM32F10xInit) 7 


i101 


102. J 
注册 板 级 初始 化 函数 到 内 核 */ 
TclSetBoardEntry (&EVB_ SetupBoard); 


TclActivateThread (&ThreadLEDOff); 


103. 
104. 


105. EA 
注册 板 级 调试 打印 函数 到 内 核 */ 
106 . TclSetTraceRoutine (&EVB_Uart1WNriteString) 7 


107 . 


108 . Lg 
注册 用 户 初始 化 函数 到 内 核 */ 
TclSetUserEntry (&APP LEDENtry); 








109. 
110. 
111. 

启动 内 核 */ 
112. 

113: 

114. 

115. 1 
116. 
175 
118 . 


六 


TclStartKernel () 7 


return 1; 


#endif 








程序 运行 后 ，LED 的 变化 如 








5-11 所 示 。 
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LED 的 变化 情况 








5.3.2 ”强制 解除 线程 阻塞 


在 本 例 中 ， 两 个 线程 通过 的 互 斥 量 的 操作 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 其 中 LED 线 程 以 阻塞 方式 尝试 获取 互 斥 量 ， 然 后 根据 操作 结果 进行 LED 的 控制 : 如 果 返 回 结果 是 elpcAbort 则 点 亮 LED; 然 
后 再 次 以 阻塞 方式 尝试 获取 互 斥 量 ， 如 果 返 回 结果 是 elpcAbort 则 熄灭 LED;， 循环 往复 。 而 控制 线程 则 每 隔 1 秒 对 互 斥 量 执行 一 次 Abort 操 作 。 程 序 实现 如 代码 清单 5-5 所 示 。 








代码 清单 5-5: 互 斥 量 应 用 例 程 2 





Ls #include "example.h" 

2 #inclugde “trochili.h" 

3 

4. #if (EVB EXAMPLE == CH5 MUTEX EXAMPLE2) 
和 

6. A 

用 户 线程 参数 */ 

3 #define THREAD LED STACK SIZE (256*2) 
站 #define THREAD LED PRIORITY {5) 

9 #define THREAD LED SLICE (2000) 
10. 

i #define THREAD CTRL STACK SIZE (256*2) 
2 #define THREAD CTRL PRIORITY (4) 

1 #define THREAD CTRL SLICE (2000) 
14. 


15 ye 
用 户 线程 栈 定义 */ 


16s static TThread ThreadLED; 
Ls static TThread ThreadCTRL; 
18. 


19， ve 
用 户 线程 栈 定义 */ 


20 . static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
2 static TWord ThreadCTRLStack[THREAD CTRL STACK SIZE]; 
2 

23. Be 


用 户 互 斥 量 定义 */ 





24. static TMutex LedMutex; 

区 5。 

26. /* LED 

线程 的 主 函数 */ 

27 static void ThreadLEDENtry (void* pArg) 
28. { 

2 TErrno errno; 

0 TState state; 

31. 

32. while (eTrue) 

33. { 

34. /* LED 

线程 以 阻塞 方式 获取 互 斥 量 ， 被 强制 解除 阻塞 后 点 亮 LED */ 
355 state = TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 


if ((state != eSuccess) && (errno & ERR IPC ABORT)) 
37. { 


38, EVB_LEDControl (LED1, LED ON); 
39. } 
i 
/* LED 
和 ws 区 了 生生 被 强制 解除 阻塞 后 熄灭 LED */ 
state = TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 








5 if ((state != eSuccess) && (errno & «ERR IPC ABORT)) 
44. { 

45. EVB_LEDControl (LED1, LED OFF); 
46. F 

47. 

48 . } 

49. 

50 . 

51 . i 

主 控 线程 的 主 函 数 */ 

SR static void ThreadCTRLENtry (void* pArg) 


TErrno errno; 


/* 
阻塞 方式 获取 互 斥 量 */ 

TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 
while (eTrue) 








/* 





线程 延 时 1 
秒 后 强制 解除 LED 


线程 的 阻塞 */ 

61. TclDelayThread (&ThreadCTRL, MLS2TICKS (1000)); 
2 TclAbortMutex (&LedMutex， &ThreadLED, &errno) / 
63. } 

64. } 

65. 

66. 


67. J , 

用 户 应 用 程序 入 口 函数 */ 

68 . static void APP LEDEntry (void) 
人 95 4 

人 30, TErrno errno; 

71. 


了 2 站 
配置 使 能 评估 板 上 的 LED 
设备 */ 


池 汪 > EVB_LEDConfig () 7 
74. 








Fa 

初始 化 互 斥 量 */ 

2 TclInitMutex (&LedMutex，IPC_PROP NONE, &errno) 

77. 

78 . 1 

初始 化 LED 

设备 控制 线程 */ 

79. TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
80 . ThreadLEDStack，THREAD LED STACK SIZE, 

81. THREAD LED PRIORITY, THREAD ] LED ) SLICE); 

和 

83 , 了 

初始 化 CTRL 

线程 */ 

84. TclInitThread (&ThreadCTRL， &ThreadCTRLENtry, (void*)NULL, 
B56; ThreadCTRLStack, THREAD CTRL STACK SIZE, 
86. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
7 

88. 

激活 LED 

设备 控制 线程 */ 
89. TclActivateThread (&ThreadLED); 
90. 
Sl nd 

激活 主 控 线程 */ 

92 . TclActivateThread (&ThreadCTRIL) 
93 . J 

94. 

955 

96. Le 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提 供 */ 

97 . int main (void) 

98 . { 


: i 
注册 处 理 器 初始 化 函数 到 内 核 */ 
100. TclSetCpuEntry (&CPU_STM32F10xInit); 





Ls 
注册 板 级 初始 化 函数 到 内 核 */ 
403% TclSetBoardEentry (&EVB_SetupBoard); 


De A 
注册 板 级 调试 打印 函数 到 内 核 */ 
106. TclSetTraceRoutine (&EVB_Uart1WriteString) 7 








注 攻 户 初始化 鱼 数 到 内 核 3 
109. TclSetUserEntry (&APP LEDENtry); 


Ee A 

启动 内 核 */ 

Ll TclStartKernel (); 
T13; 

114. return 1; 

115% } 

116. 

My 

118. #endif 








程序 运行 后 ，LED 的 变化 如 图 5-12 所 示 。 
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5-12 LED 的 变化 情况 














5.3.3， 互 斥 量 刷新 


在 本 例 中 ， 两 个 线程 通过 的 互 斥 量 的 操作 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭。 

















其 中 LED 线 程 以 阻塞 方式 尝试 获取 互 斥 量 ， 然 后 根据 操作 结果 进行 LED 的 控制 : 如 果 返 回 结果 是 elpcFlush 则 点 亮 LED， 然后 再 次 以 阻塞 方式 尝试 获取 互 斥 量 ， 如 果 返 
环 往复 。 而 控制 线程 则 每 隔 1 秒 对 互 斥 量 执行 一 次 刷新 操作 。 程 序 实 现 如 代码 清单 5-6 所 示 。 





回 





结果 是 elpcFlush 则 熄灭 LED; 循 





代码 清单 5-6: 互 斥 量 应 用 例 程 3 








Ls #include "example.h" 

六 #include "trochili.h" 

3 

4. #if (EVB EXAMPLE == CH5 MUTEX EXAMPLE3) 

: 

6. /* 

用 户 线程 参数 */ 

Ee #define THREAD LED STACK SIZE (256*2) 

生 ， #define THREAD LED PRIORITY (5) 

9。 #define THREAD LED SLICE (20) 

10. 

11. #define THREAD CTRL STACK SIZE (256*2) 
125 #define THREAD CTRI PRIORITY (4) 

3 #define THREAD CTRL SLICE (20) 

14. 

5s 

用 户 线程 定义 */ 

Tb。 static TThread ThreadLED; 

17, static TThread ThreadcTRLi; 

1 

19. J 

用 户 线程 栈 定义 */ 

20 . static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
2 static TWord ThreadCTRLStack[THREAD CTRL STACK SIZE]; 
22. 

3 

用 户 互 斥 量 定 义 */ 

24. static TMutex LedMutex; 

5s 

26. /* LED 

线程 的 主 函数 */ 

将 static void ThreadqLEDEntry (void* pArg) 
28. { 

人 光 TErrno errno; 

30. 

有 TState state; 

32.。 while (eTrue) 

33. 是 

34 /*_ LED 

线程 以 阻塞 方式 获取 互 扩 量 ， 当 发 现 互 斥 量 ELush 

后 点 亮 LED */ 

二 state = TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 
36. if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 
3 { 

38 . EVB_LEDControl (LED1, LED ON) ， 
39; bs 

40. 


41. /* LED 

线程 以 阻塞 方式 获取 互 斥 量 ， 当 发 现 互 斥 量 flush 

后 熄灭 LED */ 

42. state = TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 
43. if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 
44. 

45. EVB LEDControl (LED1, LED OFF); 

46. 号 

47. } 

48. } 

49. 

SQ 


Sl 人 

主 控 线 程 的 主 函 数 */ 

52 static void ThreadCTRLENtry (Void* pArg) 
53。 { 

54. TErrno errno; 

55。 


56 . 人 

主 控 线 程 首 先 获取 互 斥 量 */ 

县 区， TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 
58. while (eTrue) 

9 { 


60 . 

主 控 线程 延 时 1 
秒 后 FELUSH 
互 斥 量 */ 

61. TclDelayThread (&ThreadCTRL, MLS2TICKS (1000)); 
62 . TclFlushMutex (&LedMutex, &errno); 





/* 


全 7 


六 


用 户 应 用 入 口 函 数 */ 


68 . 
09 
了 
ep 


72. 
板 级 初始 化 函 
3 





91 . 
激活 LED 


线程 
92. 
93. 
94. 
激活 
95 





96 . 
97， 
98 . 
处 理 


99 
100. 
101 
注 
102. 
103. 
104 
注 
105. 
106. 
107 
注 
108 
109. 
110 
注 
111,; 
112:; 








113: 
启动 内 核 */ 


114. 
115, 
116. 
LIT 
i183 


化 信号 量 


static void APP LEDENtry (void) 
{ 


TErrno errno; 


/# 
Ey 
EVB_SetupBoard (); 


/* 
使 能 评估 板 上 的 LED 


有 

EVB_LEDConfig (); 
/* 

本 


TclInitMutex (&LedMutex，IPC_PROP NONE, &errno); 


/* 


化 LED 
控制 线程 


wd 

TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
ThreadLEDStack, THREAD LED STACK SIZE, 
THREAD LED PRIORITY, THREAD LED SLICE); 


/* 

TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
ThreadCTRLStack, THREAD CTRL STACK SIZE, 
THREAD CTRL PRIORITY, THREAD CTRL SLICE); 

/* 


We 
TclActivateThread (&ThreadLED); 
大 
E 控 线程 */ 
TclActivateThread (&ThreadCTRL); 
} 


A 


E 器 BOOT 
之 后 会 调用 main 


必须 提供 */ 
int main (void) 


{ 


. Ei 
处 理 器 初始 化 函数 到 内 核 */ 


TclSetCpuEntry (&CPU_STM32F10xInit); 


. ee 
板 级 初始 化 函数 到 内 核 */ 


TclSetBoardEentry (&EVB_ SetupBoard); 


We 
板 级 调试 打印 函数 到 内 核 */ 


TclSetTraceRoutine (&EVB UartlWritestring); 


i Ey 
用 户 初始 化 函数 到 内 核 */ 


TclSetUserEntry (&APP LEDENtry); 
大 
TclstartKernel (); 


return 1; 





程序 运行 后 ，LED 的 变化 如 














5-13 所 示 。 
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5-13 LED 的 变化 情况 
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5.3.4 ， 互 斥 量 取消 初始 化 


在 本 例 中 ， 两 个 线程 通过 的 互 斥 量 的 操作 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 其 中 LED 线 程 以 阻塞 方式 尝试 获取 互 斥 量 ， 然 后 根据 操作 结果 进行 LED 的 控制 : 如 果 返 回 结果 是 elpcDeinit 则 点 亮 LED; 然 
后 再 次 以 阻塞 方式 尝试 获取 互 斥 量 ， 如 果 返 回 结果 是 elpcDeinit 则 熄灭 LED， 循环 往复 。 而 控制 线程 则 每 隔 1 秒 对 互 斥 量 执行 一 次 取消 初始 化 操作 ， 然 后 重新 初始 化 互 斥 量 。 程 序 实现 如 代码 清单 5-7 所 示 。 








代码 清单 5-7: 互 斥 量 应 用 例 程 4 





#include "example.h" 
#include "trochili.h" 


#if (EVB EXAMPLE == CH5 MUTEX FXAMPLE4) 


ao wb 


/* LED 


设备 克 数 */ 





#define LED ON (1) 
和 #define LED OFF (0) 
#define LED INDEX (1) 
了 
这 
用 户 线程 才 数 #/ 
Te #define THREAD LED STACK SIZE (256*2) 
x #define THREAD LED PRIORITY (5) 
14. #define THREAD LED SLICE (20) 
J 
十 6。 #define THREAD CTRL STACK SIZE (256*2) 
的 #define THREAD CTRI PRIORITY (4) 
18. #define THREAD ( CTRL : SLICE (20) 
19. 
20. Ms 
用 户 线程 定义 */ 
i static TThread ThreadLED; 
总 static TThread ThreadcTRL; 
23. 
24. J 
用 户 线 程 栈 定义 */ 
2 static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
6 static TWord ThreadCTRLStack [THREAD CTRL STACK SIZE]; 
大全 
28 . 汪汪 
用 户 互 斥 量 定义 */ 
295 static TMutex LedMutex; 
30. 
31. /* LED 
线程 的 主 函 数 */ 
3 static void ThreadLEDEnNtry (void* pArg) 
3 { 
区 和 5 TErrno errno; 
3 TState state; 
36. while (eTrue) 
3 { 





/*_ LED 
2 和 ws 其 了 全 和 当 发 现 互 斥 量 重 置 后 点 亮 LED */ 
state = TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 





a if ((state != eSuccess) && (errno & ERR_ IPC DEINIT)) 
41. { 
42. EVB_LEDControl (LED INDEX, LED ON); 
43. } 
色 
/* LED 





久 和 有 方式 奖 取 和 后， 当 发 现 互 斥 量 重 置 后 熄灭 LED */ 
state = TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 

















a if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 
48. { 

49. EVB_LEDControl (LED INDEX, LED OFF); 
50 . 

51. 本 

B23 二 

53。 

54. 

S55 

线程 的 主 画 数 人 

S56; static void ThreadCTRLENtry (void* pArg) 

57. { 

58 . TErrno errno; 

S59 

60. while (eTrue) 

61. 和 

62 2 





主 控 线程 初始 化 互 斥 量 ， 然 后 提前 获得 互 斥 量 */ 


G63 TclInitMutex (&LedMutex, IPC PROP NONE, &errno); 
64. TclLockMutex (&LedMutex, IPC OPT WAIT, 0, &errno); 
65. 

66. 区 





主 控 线程 延 时 1 

黎 ， 此 后 LED 

二 得 小 得 到 运行 机 会 */ 

TclDelayThread (&ThreadCTRL, MLS2TICKS (1000)); 














A 
线程 重 置 互 斥 量 */ 

0 TclDeinitMutex (&LedMutex, &errno); 
Js } 
2 Ff 
73. 
74. 
75, /* 


怖 让 入 用 从 喇 哺 数 yy 
static void APP LEDENtry (void) 
{ 


78. 下 

配置 使 能 评估 板 上 的 LED 

设备 */ 

79. EVB_LEDConfig () 7 


8T。 4 
初始 化 LED 
fd /6 

TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
8 ThreadLEDStack，THREAD LED STACK SIZE, 
84. THREAD LED PRIORITY, THREAD LED SLICE); 
85. 
86. 了 
初始 化 CTRL 
线程 */ 
gs TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
88. ThreadcTRLStack, THREAD CTRL STACK SIZE, 
89 . THREAD CTRL PRIORITY, THREAD _ CTRL SLICE); 
90. 
91. 人 
激活 LED 
线程 */ 
TclActivateThread (&ThreadLED); 


94 . 

激活 主 控 线程 */ 

95;, TclActivateThread (&ThreadCTRL); 
96. : 





98 . 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提 供 */ 

99 . int main(void) 
100 . { 


注 你 理 吕 初始 化 函数 到 内 核 4 
2 TclSetCpuEntry (&CPU_STM32F10xInit); 


注 入 级 初 给 化 了 数 到 内 核 人 
09 TclSetBoardEentry (&EVB_SetupBoard); 


i A 
注册 板 级 调试 打印 函数 到 内 核 */ 
108 . TclSetTraceRoutine (&EVB_Uart1WNriteString) 7 





0. 3 
注册 用 户 初始 化 函数 到 内 核 */ 
111. TclSetUserEntry (&APP LEDENtry); 


区 这 
启动 内 核 */ 


114. Tc1LStartKernel (); 


116, return 1; 
TI17。 Es 


120.  #endif 








程序 运行 后 ，LED 的 变化 如 图 5-14 所 示 。 
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5-14 LED 的 变化 情况 














第 6 章 ”邮箱 设计 实现 


邮箱 是 RTOS 提 供 的 最 简单 的 用 于 任务 间或 者 任务 与 ISR 间 的 通信 和 同步 机 制 。 本 章 详细 介绍 邮箱 的 概念 、 用 途 、 设 计 与 实现 。 


6.1 ”邮箱 基础 知识 


6.1.1 ”邮箱 的 概念 














邮箱 和 前 面 介绍 的 信号 量 相 比 ， 除 了 同样 具有 任务 同步 功能 外 ， 它 还 可 以 用 来 传递 数据 ， 它 有 一 个 数据 单元 (邮件 ) 。 邮 件 可 以 是 一 个 具体 的 数据 结构 ， 也 可 以 是 一 个 指向 任意 数据 类 型 的 指针 。 任 务 
间或 者 任务 和 1SR 间 可 以 通过 邮箱 传递 各 种 类 型 的 邮件 。 在 实际 应 用 中 ， 不 同 的 应 用 可 能 需要 不 同 结构 的 邮件 ， 这 就 要 求 内 核 必须 提供 灵活 的 邮件 支持 方式 。 





















































1. 邮箱 的 状态 


邮箱 通常 拥有 两 种 状态 : 空 和 满 。 当 邮箱 刚刚 建立 时 ， 它 处 于 空 的 状态 。 当 有 邮件 发 送 进来 时 ， 它 的 状态 转 为 满 。 当 邮件 被 读 出 后 ， 它 的 状态 随 之 变 为 空 。 随 着 邮件 的 写 入 和 读 出 ， 邮 箱 的 状态 在 这 两 
种 情况 下 相互 转换 ， 符 合 有 限 状态 机 机 制 。 





当 邮 箱 处 于 空 的 状态 时 ， 如 果 有 任务 来 读 取 邮 件 ， 那 么 该 任务 直接 返回 失败 ， 或 者 阻塞 到 该 邮箱 上 ， 直 到 有 可 读 的 邮件 或 者 任务 阻塞 时 限期 满 ， 当 邮箱 处 于 满 的 状态 时 ， 如 果 有 任务 来 发 送 邮件 ， 那 么 
该 任务 直接 返回 失败 ,或 者 阻塞 到 该 邮箱 上 。 注 意 |SR 操 作 上 邮箱 时 ， 只 能 立刻 返回 操作 结果 ， 这 是 因为 ISR 不 能 被 阻塞 。 
































到 6-1 描 述 了 邮箱 的 状态 迁移 和 原因 。 








玫 _ 
忆 Se 7 pp y yA 
邮箱 初始 


N 
、 


2. 邮件 传输 方式 


化 


发 送 1 个 邮件 





读 取 1 个 邮件 


图 6-1 ”邮箱 状态 迁 


邮件 在 任务 间或 者 任务 和 1SR 间 传递 时 ， 出 于 性 能 考虑 ， 有 以 下 两 种 方式 : 











移 图 





“ 一 种 方式 是 把 任务 发 送 过 来 的 邮件 完全 从 该 任务 的 空间 复制 到 邮箱 中 。 然 后 当 接 收 任务 来 接收 邮件 时 ， 再 将 邮件 从 邮箱 中 的 空间 复制 到 接收 任务 的 空间 。 


“ 另 一 种 方式 是 在 邮箱 中 只 保存 邮件 的 指针 ， 而 不 是 邮件 完整 的 内 容 。 需 要 应 用 任务 处 理 邮 件数 据 的 复制 和 内 存 的 管理 。 











第 一 种 方式 的 缺点 是 效率 低 ， 需 要 复制 两 次 完整 的 数据 ， 这 两 次 复制 发 生 在 发 送 者 把 邮件 发 送 到 邮箱 和 接收 者 从 邮箱 读 取 邮 件 的 时 候 ， 如 图 6-2 所 示 。 


邮箱 接收 邮件 的 任务 





发 送 邮 件 的 任务 








第 二 种 方式 在 对 内 存 的 使 用 和 性 能 上 是 比较 有 利 的 。 
6-3 所 示 。 




















图 6-2 邮件 复制 方式 传输 





因为 此 时 邮箱 传递 的 是 指针 而 不 是 实际 数据 ， 不 过 正 





因 如 此 ， 如 果 指 针 指 向 的 内 存 得 不 到 妥善 的 处 理 ， 就 会 造成 内 存 泄漏 或 者 内 存 地 址 非法 ， 如 图 









发 送 邮 件 的 任务 


接收 邮件 的 任务 
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3. 任务 阻塞 队列 





邮箱 具有 任务 阻塞 的 能 力 ， 名 义 上 邮箱 拥有 两 个 不 同类 型 的 任务 阻塞 队列 ， 代 表 了 接收 邮件 的 任务 阻塞 队列 和 发 送 邮件 任务 的 阻塞 队列 。 而 实现 上 只 需要 一 个 任务 阻塞 队列 即 可 ， 因 为 不 可 能 同时 阻塞 
这 样 的 两 个 任务 : 一 个 不 能 获得 邮件 而 另 一 个 不 能 发 送 邮件 。 








需要 注意 的 是 ， 当 邮箱 为 空 时 ， 如 果 有 任务 处 于 邮箱 的 任务 阻塞 队列 中 ， 说 明 当 前 邮箱 的 任务 阻塞 队列 是 邮件 读 取 任务 队列 。 如 果 此 时 有 任务 向 邮箱 中 发 送 邮件 ， 可 以 直接 从 邮箱 的 任务 阻塞 队列 中 找 
到 一 个 合适 的 任务 ， 并 直接 使 得 它 读 取 邮件 成 功 ， 同 时 邮箱 的 状态 不 变 。 在 这 种 情况 下 ， 邮 件 传递 过 程 中 只 发 生 一 次 邮件 (或 指针 ) 复制 。 同 理 ， 在 邮箱 可 以 读 取 时 ， 如 果 有 任务 处 于 邮箱 的 任务 阻塞 队 
列 ， 说 明 当 前 邮箱 的 任务 阻塞 队列 是 邮件 发 送 任务 队列 ， 假 如 此 时 有 任务 来 读 取 邮件 ， 可 以 先 从 邮箱 中 读 取 邮 件 ， 然 后 再 从 邮箱 的 任务 阻塞 队列 中 找到 一 个 合适 的 任务 ， 并 且 完 成 它 的 邮件 发 送 操作 。 此 时 
邮箱 状态 同样 保持 不 变 。 


6.1 ”邮箱 基础 知识 


6.1.1 ”邮箱 的 概念 











邮箱 和 前 面 介绍 的 信号 量 相 比 ， 除 了 同样 具有 任务 同步 功能 外 ， 它 还 可 以 用 来 传递 数据 ， 它 有 一 个 数据 单元 (邮件) 。 邮 件 可 以 是 一 个 具体 的 数据 结构 ， 也 可 以 是 一 个 指向 任意 数据 类 型 的 指针 。 任 务 
间或 者 任务 和 ISR 间 可 以 通过 邮箱 传递 各 种 类 型 的 邮件 。 在 实际 应 用 中 ， 不 同 的 应 用 可 能 需要 不 同 结构 的 邮件 ， 这 就 要 求 内 核 必须 提供 灵活 的 邮件 支持 方式 。 




















1 邮箱 的 状态 


邮箱 通常 拥有 两 种 状态 : 空 和 满 。 当 邮箱 刚刚 建立 时 ， 它 处 于 空 的 状态 。 当 有 邮件 发 送 进来 时 ， 它 的 状态 转 为 满 。 当 邮件 被 读 出 后 ， 它 的 状态 随 之 变 为 空 。 随 着 邮件 的 写 入 和 读 出 ， 邮 箱 的 状态 在 这 两 
种 情况 下 相互 转换 ， 符 合 有 限 状 态 机 机 制 。 


当 邮 箱 处 于 空 的 状态 时 ， 如 果 有 任务 来 读 取 邮 件 ， 那 么 该 任务 直接 返回 失败 ， 或 者 阻塞 到 该 邮箱 上 ， 直 到 有 可 读 的 邮件 或 者 任务 阻塞 时 限期 满 ; 当 邮 箱 处 于 满 的 状态 时 ， 如 果 有 任务 来 发 送 邮件 ， 那 么 
该 任务 直接 返回 失败 ,或 者 阻塞 到 该 邮箱 上 。 注 意 |SR 操 作 上 邮箱 时 ， 只 能 立刻 返回 操作 结果 ， 这 是 因为 ISR 不 能 被 阻塞 。 























图 6-1 描 述 了 邮箱 的 状态 迁移 和 原因 。 
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图 6-1 ”邮箱 状态 迁 


邮件 在 任务 间或 者 任务 和 1SR 间 传递 时 ， 出 于 性 能 考虑 ， 有 以 下 两 种 方式 : 
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“ 一 种 方式 是 把 任务 发 送 过 来 的 邮件 完全 从 该 任务 的 空间 复制 到 邮箱 中 。 然 后 当 接 收 任务 来 接收 邮件 时 ， 再 将 邮件 从 邮箱 中 的 空间 复制 到 接收 任务 的 空间 。 


“ 另 一 种 方式 是 在 邮箱 中 只 保存 邮件 的 指针 ， 而 不 是 邮件 完整 的 内 容 。 需 要 应 用 任务 处 理 邮 件数 据 的 复制 和 内 存 的 管理 。 











第 一 种 方式 的 缺点 是 效率 低 ， 需 要 复制 两 次 完整 的 数据 ， 这 两 次 复制 发 生 在 发 送 者 把 邮件 发 送 到 邮箱 和 接收 者 从 邮箱 读 取 邮 件 的 时 候 ， 如 图 6-2 所 示 。 


邮箱 接收 邮件 的 任务 





发 送 邮 件 的 任务 








第 二 种 方式 在 对 内 存 的 使 用 和 性 能 上 是 比较 有 利 的 。 
6-3 所 示 。 




















图 6-2 邮件 复制 方式 传输 





因为 此 时 邮箱 传递 的 是 指针 而 不 是 实际 数据 ， 不 过 正 





因 如 此 ， 如 果 指 针 指 向 的 内 存 得 不 到 妥善 的 处 理 ， 就 会 造成 内 存 泄漏 或 者 内 存 地 址 非法 ， 如 图 
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3. 任务 阻塞 队列 





邮箱 具有 任务 阻塞 的 能 力 ， 名 义 上 邮箱 拥有 两 个 不 同类 型 的 任务 阻塞 队列 ， 代 表 了 接收 邮件 的 任务 阻塞 队列 和 发 送 邮件 任务 的 阻塞 队列 。 而 实现 上 只 需要 一 个 任务 阻塞 队列 即 可 ， 因 为 不 可 能 同时 阻塞 
这 样 的 两 个 任务 : 一 个 不 能 获得 邮件 而 另 一 个 不 能 发 送 邮件 。 





需要 注意 的 是 ， 当 邮箱 为 空 时 ， 如 果 有 任务 处 于 邮箱 的 任务 阻塞 队列 中 ， 说 明 当 前 邮箱 的 任务 阻塞 队列 是 邮件 读 取 任务 队列 。 如 果 此 时 有 任务 向 邮箱 中 发 送 邮件 ， 可 以 直接 从 邮箱 的 任务 阻塞 队列 中 找 
到 一 个 合适 的 任务 ， 并 直接 使 得 它 读 取 邮件 成 功 ， 同 时 邮箱 的 状态 不 变 。 在 这 种 情况 下 ， 邮 件 传递 过 程 中 只 发 生 一 次 邮件 (或 指针 ) 复制 。 同 理 ， 在 邮箱 可 以 读 取 时 ， 如 果 有 任务 处 于 邮箱 的 任务 阻塞 队 
列 ， 说 明 当 前 邮箱 的 任务 阻塞 队列 是 邮件 发 送 任务 队列 ， 假 如 此 时 有 任务 来 读 取 邮件 ， 可 以 先 从 邮箱 中 读 取 邮 件 ， 然 后 再 从 邮箱 的 任务 阻塞 队列 中 找到 一 个 合适 的 任务 ， 并 且 完 成 它 的 邮件 发 送 操作 。 此 时 
邮箱 状态 同样 保持 不 变 。 





6.1.2 ”邮箱 的 操作 


常见 的 邮箱 功能 如 表 6-1 所 示 。 


表 6-1 邮箱 功能 


功能 
1 邮箱 创建 broadcast 向 邮箱 广播 邮件 

2 邮箱 删除 刷新 邮箱 任务 阻塞 队列 
3 从 邮箱 中 接收 邮件 邮箱 查询 

4 send 问 邮 箱 发 送 邮 件 上 











(1) Create 邮 箱 创 建 


创建 邮箱 时 ， 用 户 可 以 指定 邮箱 的 各 种 参数 属性 。 比 如 针对 多 个 任务 在 邮箱 上 的 阻塞 和 调度 方式 : 既 可 以 配置 成 先进 先 出 的 FIFO 方 式 ， 也 可 以 按照 任务 优先 级 来 处 理 。 


《区 


Delete 邮 箱 删除 
删除 邮箱 时 ， 需 要 把 所 有 阻塞 在 邮箱 上 的 任务 解除 阻塞 ， 并 且 清空 邮件 ， 如 果 是 动态 分 配 的 资源 还 需要 释放 它 所 占 的 存储 空间 。 邮 箱 一 旦 被 删除 ， 就 不 能 再 次 操作 了 。 


(3) Receive 从 邮箱 中 接收 邮件 





如 果 邮 箱 为 空 ， 则 当前 任务 直接 返回 ， 或 者 阻塞 在 邮箱 的 任务 阻塞 队列 中 ; 如 果 邮箱 状态 为 满 ， 则 任务 首先 从 邮箱 中 取得 邮件 ， 然 后 检查 邮箱 的 任务 阻塞 队列 中 是 否 有 因为 邮箱 满 而 无 法 成 功 发 送 邮件 
的 任务 ， 如 果 有 则 应 把 其 中 一 个 合适 的 任务 唤醒 ， 并 把 它 需要 发 送 的 邮件 放 入 邮箱 ; 如 果 此 时 没有 任务 被 阻塞 ， 则 当前 任务 直接 返回 。 


(4) Send 向 邮箱 发 送 邮件 


如 果 邮 箱 为 满 ， 则 当前 任务 直接 返回 ， 或 者 阻塞 在 邮箱 的 任务 阻塞 队列 中 ; 如 果 邮 箱 为 空 ， 那 么 任务 会 检查 是 否 有 任务 因 无 法 获得 邮件 而 被 阻塞 ， 如 果 有 则 会 把 邮件 直接 发 给 其 中 某 个 恰当 的 被 阻塞 任 
务 ， 随 后 当前 任务 返回 ;如果 此 时 没有 任务 被 阻塞 ， 则 当前 任务 直接 发 送 邮件 到 邮箱 并 且 返 回 。 


(5) Broadcast 向 邮箱 广播 邮件 

当 有 多 个 任务 因为 不 能 接收 到 邮件 而 阻塞 在 邮箱 时 ， 可 以 通过 广播 方式 向 这 些 任务 发 送 相 同 的 邮件 ， 完 成 多 任务 的 同步 和 通信 。 得 到 相同 邮件 的 多 个 任务 需要 谨慎 处 理 广播 的 邮件 。 
(6) Flush 刷 新 邮箱 任务 阻塞 队列 

当 有 多 个 任务 因为 不 能 接收 或 者 发 送 邮 件 而 阻塞 在 邮箱 时 ， 可 以 通过 Flush 操 作 将 这 些 任 务 解除 阻塞 ， 完 成 多 任务 的 同步 


(7) Query 


用 户 可 以 通过 查询 操作 获得 邮箱 当前 的 详细 信息 。 


6.1.3 ”邮箱 的 典型 应 用 





邮箱 在 实际 使 用 中 ， 有 它 自己 特殊 的 模式 ， 下 面 介绍 几 个 常见 的 邮箱 的 使 用 模型 。 





1. 单 向 异步 数据 传输 


在 这 种 模式 下 ， 一 个 任务 用 来 从 邮箱 接收 邮件 ， 另 外 一 个 任务 或 者 ISR 向 邮箱 中 发 送 邮件 。 发 送 任务 或 1SR 不 必 了 解 接收 任务 的 情况 。 如 图 6-4 所 示 。 


发 送 邮 件 的 任务 或 者 ISR 








邮箱 


6-4 ” 单 向 异步 数据 传输 














接收 邮件 的 任务 


在 这 种 模式 下 ， 系 统 的 行为 和 两 个 任务 的 优先 级 是 密切 相关 的 (ISR 的 优先 级 必然 高 于 任务 的 优先 级 ) 。 首 先 我 们 假设 两 个 任务 分 别 不 停 地 发 送 和 接收 邮件 。 





“ 假如 发 送 任务 的 优先 级 高 于 接收 的 优先 级 ， 那 么 发 送 任务 会 首先 发 送 邮 件 到 邮箱 中 ， 如 果 此 时 它 想 再 次 发 送 邮 件 ， 则 会 阻塞 在 邮箱 的 任务 阻塞 队列 上 ; 随后 接收 任务 才 会 得 以 运行 ， 读 取 到 邮件 ， 而 
这 个 操作 导致 发 送 任务 立刻 被 唤醒 和 抢占 处 理 器 ， 同 时 发 送 任务 的 邮件 发 送 操作 会 成 功 完成 。 随 后 邮件 发 送 任务 会 再 发 送 一 个 邮件 ， 此 时 邮箱 满 ， 发 送 任务 会 再 次 阻塞 。 然 后 接收 任务 再 次 运行 ， 再 次 接收 
第 二 个 邮件 ， 就 这 样 循 环 下 去 ， 邮 件 按照 时 间 先 后 被 接收 任务 处 理 。 在 这 种 情况 下 ， 邮 箱 一 直 是 满 的 ， 除 非 发 送 任务 不 再 发 送 新 的 邮件 。 


“ 假如 发 送 任务 的 优先 级 低 于 接收 任务 的 优先 级 ， 那 么 接收 任务 首先 执行 ， 因 为 邮箱 开始 时 是 空 的 ， 所 以 接收 任务 立刻 阻塞 在 邮箱 的 任务 阻塞 队列 上 。 随 后 发 送 任务 得 到 处 理 器 并 发 送 一 个 邮件 到 邮箱 
中 ， 因 为 此 时 邮箱 为 空 并 且 有 任务 阻塞 在 任务 阻塞 队列 中 等 待 接 收 邮 件 ， 所 以 内 核 会 把 发 送 的 邮件 直接 发 给 接收 任务 ， 并 且 因为 优先 级 抢占 ， 接 收 任务 立刻 抢占 执行 。 因 为 邮箱 此 时 保持 空 的 状态 ， 所 以 接 
收 任务 会 因 再 次 接收 邮件 而 再 次 阻塞 。 而 此 后 发 送 任务 再 次 运行 ， 再 次 尝试 发 送 一 个 邮件 到 邮箱 ， 接 收 任务 也 再 次 被 唤醒 。 在 这 种 情况 下 ， 邮 箱 一 直 是 空 的 。 








ISR 通 常 使 用 第 一 种 方式 ， 因 为 ISR 是 要 抢占 任何 任务 来 执行 的 。 另 外 ，ISR 必 须 使 用 非 阻塞 方式 来 发 送 邮件 ， 如 果 发 送 操作 不 能 成 功 则 邮件 会 丢失 。 








这 种 模式 的 伪 代 码 如 代码 清单 6-1 所 示 。 


代码 清单 6-1: 邮箱 单 向 异步 使 用 





2 void TaskSender (void) 
23。 { 
24. 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 
25: 
Send mail to Mailbox; 
26. 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 
27. } 
区 5。 
29. void TaskReceiver (void) 
30 . 
1: 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 
32。 
Receive Mail from Mailbox; 
23 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 


34. } 


.http://www.hzcourse. 


.http://www.hzcourse. 


.http://www.hzcourse. 


.http://www.hzcourse. 


com/resource/readBook?path=/openresources/teacl 


com/resource/readBook?path=/openresources/teacl 


com/resource/readBook?path=/openresources/teacl 


com/resource/readBook?path=/openresources/teacl 





2. 单 向 同步 数据 传输 





有 了 时候 ， 任 务 发 送 邮 件 后 ， 希 望 得 到 邮件 接收 任务 的 确认 ， 也 就 是 说 ， 发 送 过 程 和 接收 过 程 有 同步 的 约定 。 这 样 来 说 ， 系 统 的 可 靠 性 就 更 高 了 。 同 步 过 程 可 以 通过 前 面 介绍 的 二 值 信号 量 来 实现 ， 如 


6-5 所 示 。 
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“获得 信号 量 释放 信号 量 ” 





6-5 单 向 同 











在 图 
设 两 个 任务 分 别 不 停 地 发 送 和 接收 邮件 。 





步 数据 传输 


6-5 所 示 的 模型 中 ， 包 括 一 个 二 值 信号 量 、 一 个 邮箱 和 两 个 任务 。 初 始 时 ， 信 号 量 为 0， 邮 箱 为 空 。 每 次 邮件 传递 都 有 1 次 信号 量 的 同步 ， 两 个 任务 按照 发 送 -接收 -确认 的 流程 来 执行 。 我 们 同样 假 


假设 两 个 任务 优先 级 相同 ， 并 且 发 送 邮 件 的 任务 首先 运行 。 发 送 任务 首先 发 送 1 个 邮件 到 邮箱 中 ， 然 后 去 获取 信和 号 量 ， 因 为 信号 量 初始 时 为 0， 所 以 发 送 任务 阻塞 在 信号 量 的 任务 阻塞 队列 上 。 随 后 接收 
任务 开始 执行 ， 接 收 任务 首先 从 邮箱 中 读 取 一 封 邮件 ， 处 理 完 毕 后 再 去 释放 信号 量 ， 确 认 邮 件 已 经 被 正确 接收 和 处 理 了 。 





注意 因为 SR 不 能 阻塞 ， 所 以 不 适用 于 邮箱 的 这 个 模式 。 这 种 模式 的 伪 代 码 如 代码 清单 6-2 所 示 。 





忆 


代码 清单 6-2: 邮箱 单 向 同步 使 用 








14. void TaskSender (void) 
15; { 
16. 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ 
17s Send Mail to Mailbox; 
18. Obtain binary semaphore 
19. http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 
20. } 
2 
22 void TaskReceiver (void) 
这 3。 
24 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresour 
25 Receive Mail from Mailbox; 
26. Release binary semaphore 
芋 7 http://www.hzcourse.corm/resource/readBook?path=/copenresources/teach_ebook/uncompresseqd/14878/OEBPSVText/. .http://www.hzcourse.com/resource/readBook?path=/openresour 
28. } 
3. 邮件 广播 通信 





广播 邮件 可 以 向 所 有 阻塞 在 邮箱 的 任务 阻塞 队列 上 的 任务 发 送 相同 的 邮件 。 是 一 对 多 的 关系 ， 如 图 





邮箱 


6-6 所 示 。 


图 6-6 ”邮件 广播 





如 图 6-6 所 示 














因为 多 个 任务 得 到 的 是 相同 的 邮件 ， 那 么 如 果 这 个 


， 有 多 个 任务 都 在 等 待 从 邮箱 中 读 取 邮件 。 





代码 清单 6-3: 邮箱 广播 通信 


单 6-3 所 示 。 





当 有 任务 向 邮箱 广播 邮件 时 ， 所 有 阻塞 在 邮箱 上 的 任务 都 会 同时 被 解除 阻塞 ， 并 得 到 一 个 相同 的 邮件 。 这 是 一 种 多 任务 同步 的 模型 。 这 里 需要 注 
邮件 是 动态 分 配 的， 如何 处 理 邮件 又 是 个 值得 考虑 的 事情 。 邮 件 广播 的 伪 代 码 如 代码 清 





} 


36s } 


void TaskReceiver (void) 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 


Receive Mail from Mailbox; 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 


void TaskBroadcast (void) 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 


Broadcast message to MessageQueue; 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 


.http://www.hzcourse. 


.http://www.hzcourse. 


.http://www.hzcourse. 


.http://www.hzcourse. 


com/resource/readBook?path=/openresour 


com/resource/readBook?path=/openresour 


com/resource/readBook?path=/openresour 


com/resource/readBook?path=/openresour 





6.2 ”邮箱 功能 设计 


在 前 面 我 们 详细 介绍 了 邮箱 的 概念 ， 本 节 我 们 来 分 析 在 Trochili RTOS 中 是 如 何 设计 实现 邮件 的 功能 的 。 


邮箱 和 邮件 的 结构 定义 在 文件 mailbox.h 中 ， 





具体 结构 定义 如 代码 清单 6-4 所 示 。 


代码 清单 6-4: 邮箱 结构 定义 











和 Vs 
g 件 结构 定义 */ 





总 。 typedef void* TMail; 

3 

4. Ee 
箱 结构 定义 */ 

5 typedef struct MailBoxDef 

6. { 

了 TProperty Property; Cd 

队列 中 线程 的 调度 策略 等 属性 配置 */ 

8. TMail Mail; J 
8 箱 的 邮件 对 象 

9, TMailBoxStatus Status; /* 
8 箱 的 状态 芝 / 

10 TIpcQueue Queue; Fa 
8 条 的 线 和 阻塞 队列 */ 

11 }TMailBox; 
“ Property 邮 箱 属性 : 邮箱 属性 集合 。 包 括 邮 箱 是 否 被 初始 化 、 线 程 阻塞 队列 的 调度 策略 等 。 


Mail 邮箱 中 的 邮件 : 邮箱 用 来 保存 邮件 的 成 员 变量 ， 作 为 一 个 指针 ， 它 可 能 指向 任何 地 址 。 也 就 是 说 ， 邮 件 可 以 是 动态 
的 有 效 性 〈 比 如 存在 于 栈 中 的 邮箱 


' Status 邮 箱 状 态 。 


:Queue 邮 箱 的 线程 阻塞 队列 : 


照 需要 配置 成 不 同 


结构 ) 。 
邮箱 只 有 两 个 状态 : 满 和 空 ， 代 表 邮 箱 中 是 否 存在 邮件 。 


因为 邮箱 支持 紧急 邮件 ， 所 以 内 核 会 使 用 该 队列 中 的 线程 辅助 阻塞 队列 。 
调度 策略 。 


Trochili RTOS 支 持 的 邮箱 的 功能 主要 有 以 下 几 种 : 


“ 邮箱 初始 化 


邮箱 取消 初 


-发送 邮件 人 


“ 接收 邮件 〈 


' 广播 邮件 (Broadcast) : 


' 取消 线程 阻 


: 清空 线程 阻 





对 主要 功能 函数 的 总 结 见 





(Init) : 初始 化 一 个 已 存在 的 邮箱 ， 不 管 邮箱 结构 是 由 动态 内 存 分 配 而 来 还 是 一 个 全 局 变量 。 


始 化 (Deinit) : 取消 邮箱 中 的 邮件 ， 清 空 邮 箱 的 线程 阻塞 队列 ， 


Send) : 线程 或 者 ISR 将 指定 的 昌 


Receive) : 





向 邮箱 的 线程 阻塞 队列 中 的 线程 群发 邮件 ， 每 个 线程 都 得 到 邮件 并 且 得 到 成 功 的 返回 值 。 但 多 个 线程 共享 
塞 (Abort) : 
塞 队列 (Flush) : 将 邮箱 线程 阻塞 队列 中 的 所 有 线程 都 解除 阻塞 。 
表 6-2。 


表 6-2 邮箱 功能 函数 


并 且 每 个 分 队列 都 可 以 有 各 自 的 调度 策 


箱 初始 化 之 后 才 可 以 进行 其 他 操作 。 当 前 版 本 不 支持 邮箱 


所 有 线程 都 得 到 “邮箱 被 取消 初始 化 ”的 结果 。 邮 箱 返回 初始 化 前 的 最 初 状态 。 


的 是 同一 个 邮件 。 


。 紧急 邮件 优先 普通 邮件 处 理 ， 


分 配 而 来 ， 也 可 能 是 全 局 变量 ， 甚 至 是 存在 于 线程 栈 空间 。 用 户 需要 保证 邮件 


同类 型 的 邮件 又 可 以 按 


的 动态 创建 和 删除 。 


件 发 送 到 邮箱 中 。 邮 件 的 类 型 可 以 是 普通 邮件 或 者 紧急 邮件 。 有 可 能 造成 发 送 邮 件 的 线程 阻塞 在 邮箱 的 线程 阻塞 队列 中 。 


线程 从 邮箱 中 接收 邮件 。 有 可 能 造成 发 送 邮 件 的 线程 阻塞 在 邮箱 的 线程 阻塞 队列 中 。 从 使 用 习惯 上 来 说 ， 不 建议 用 户 在 ISR 中 调用 这 个 函数 。 


将 邮箱 的 线程 阻塞 队列 中 的 一 个 线程 唤醒 ， 使 得 它 不 再 等 待 邮 件 的 收发 事件 。 可 以 将 无 限 阻塞 的 线程 或 者 时 限 等 待 的 线程 提前 唤醒 。 


SR 
对 
me 
; 
1 2 
半 
; 8 
7 加 





6.2.1 ”邮箱 的 初始 化 


调用 邮箱 初始 化 函数 比较 简单 ， 这 里 不 做 流程 分 析 。 该 函数 的 主要 步骤 是 : 
“ 设置 邮箱 属性 为 就 绪 

“ 设置 邮箱 内 邮件 为 空 

* 设置 邮箱 状态 为 空 


“ 初始 化 邮箱 线程 阻塞 队列 


6.2.2 ”邮箱 的 取消 初始 化 


邮箱 取消 初始 化 和 上 邮箱 初始 化 是 相反 的 操作 。 它 会 对 邮箱 做 如 下 操作 : 
“ 重新 设置 邮箱 为 非 初始 化 状态 
清空 邮箱 的 线程 阻塞 队列 
“ 设置 邮箱 内 邮件 为 空 
“ 设置 邮箱 状态 为 空 


“ 如 果 必 要 还 会 进行 线程 调度 





邮箱 取消 初始 化 函数 的 流程 图 如 图 6-7 所 示 。 











2 内 核 进入 独占 区 





4 语 置 好 箱 状态 为 
空 ; 清除 邮件 ; 设置 
邮箱 属性 为 未 初始 化 













“ 5 有 上 比 当前 线 \ 
<“ 程 优先 级 高 的 线 。 
程 解除 阻 星 ? 


9 内 核 退出 独占 区 








图 6-7 邮箱 取消 初始 化 流程 














流程 图 分 析 : 











STEP2 内核 进入 临界 区 。 

STEP3 首先 将 邮箱 的 线程 阻塞 队列 清空 ， 唤 醒 全 部 被 阻塞 的 线程 。 

STEP4 取消 初始 化 邮箱 状态 ; 清空 邮件 ; 取消 邮箱 的 就 绪 属 性 。 

STEP5 检查 在 清空 邮箱 的 线程 阻塞 队列 时 是 否 唤醒 了 比 当前 线程 优先 级 高 的 线程 。 

STEP6 如 果 是 ， 则 判断 内 核 是 不 是 允许 线程 调度 。 

STEP7 如 果 是 ， 则 判断 该 函数 是 不 是 被 线程 调用 。 

STEP8 如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 

STEP9 内 核 退 出 独占 区 。 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP10 ”函数 返回 。 


6.2.3 接收 邮件 


从 邮箱 中 接收 邮件 的 操作 主要 是 由 以 下 几 个 函数 来 完成 的 。 


“ 邮件 接收 接口 函数 xMailboxReceive () : 该 函数 是 邮箱 模块 向 外 提供 的 接口 函数 ， 被 内 核 API 函 数 调 用 。 它 根据 操作 模式 这 个 函数 参数 来 区 分 处 理 本 次 邮件 的 接收 操作 。 根 据 操作 模式 的 不 同 ， 操 作 可 
以 分 为 线程 模式 和 ISR 模 式 ， 还 可 以 进一步 细 分 为 线程 阻塞 方式 (无 限期 和 时 限 ) 、 线 程 立刻 返回 和 ISR 立 刻 返回 3 种 模式 。 另 外 由 该 函数 完成 和 邮箱 相关 的 内 核 数据 的 保护 工作 。 


“ 线程 接收 邮件 函数 ReceiveMail () : 该 函数 实现 了 线程 接收 邮件 的 核心 逻辑 。 它 会 首先 通过 调用 还 数 TryReceiveMail () 尝试 从 邮箱 中 读 取 邮件 ， 然 后 根据 结果 来 继续 操作 。 后 继 操 作 包 括 成 功 后 的 线 
程 调度 检查 和 失败 后 的 线程 阻塞 操作 都 是 在 这 里 完成 。 


"ISR 接收 邮件 函数 IsrReceiveMail () : 该 函数 比较 简单 。 因 为 在 用 户 ISR 里 不 会 有 线程 调度 的 问题 (线程 调度 的 远 辑 在 ISR 返 回 时 由 内 核 处 理 ) 。 它 同 线程 接收 邮件 函数 一 样 ， 同 样 是 调用 


TryReceiveMail () 函数 
“ 尝试 接收 邮件 函数 TryReceiveMail () : 这 个 函数 是 接收 邮件 的 核心 部 分 ， 它 会 根据 邮箱 状态 来 处 理 本 次 请 求 。 
“ 如 果 邮 箱 状 态 为 空 ， 则 直接 返回 失败 。 
“ 如 果 邮箱 状态 为 满 ， 则 首先 从 邮箱 中 读 取 邮 件 ， 然 后 检查 该 邮箱 的 线程 阻塞 队列 是 否 有 线程 存在 。 


“ 如 果 存 在 ， 说 明 此 时 这 些 被 阻塞 的 线程 ， 都 是 因为 邮箱 满 而 不 能 发 送 邮件 的 线程 ， 所 以 本 次 邮件 操作 不 会 对 邮箱 状态 有 任何 影响 。 此 时 需要 在 全 部 阻塞 线程 中 找到 一 个 合适 的 线程 并 解除 阻塞 ， 再 
把 该 线程 发 送 的 邮件 保存 到 邮箱 中 。 


“ 如 果 此 时 不 存在 被 阻塞 的 线程 ， 则 直接 将 邮箱 状态 置 为 空 。 





这 几 个 函数 的 层次 关系 比较 简单 。 注 意 xMailboxReceive () 起 到 的 是 分 发 调用 的 作用 ， 函 数 ReceiveMail () 和 IsrReceiveMail () 是 不 同 运行 环境 下 的 具体 操作 函数 ， 而 TryReceiveMail () 的 主要 
作用 是 操作 邮箱 对 象 。 这 几 个 函数 的 流程 如 图 6-8 至 图 6-10 所 示 。 函 数 lsrReceiveMail () 的 实现 很 简单 ， 就 不 再 详细 分 析 了 。 








1. 邮件 接收 接口 函数 





邮件 接收 接口 函数 流程 


困 
注 
网 














6-8 所 示 。 








4ISR 接收 邮件 
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流程 图 分 析 : 











STEP2 内 核 进入 独占 区 。 


STEP3 判断 是 不 是 ISR 来 读 取 邮件 。 


STEP4 如 果 是 ， 则 调用 ISR 读 邮件 函数 。 


STEP5 如 果 不 是 ， 则 调用 线程 读 邮 件 函 数 。 


STEP6 ”内核 退出 独占 区 。 
STEP7 函数 返回 。 


从 图 6-8 中 可 以 看 出 ， 这 个 函数 是 个 接口 








2. 线程 接收 邮件 函数 


线程 接收 邮件 函数 如 图 6-9 所 示 。 








会 根 


图 6-8 ”邮件 接收 接口 函数 流程 


居 操 作 类 型 判断 下 一 步 该 怎么 执行 。 











图 








ny 


5 线程 接收 邮件 


是 


Y 
是 
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线程 阻塞 阶段 


9 内 核 进 入 独占 区 








图 6-9 ”线程 接收 邮件 流程 图 
流程 图 分 析 : 
STEP2 当前 线程 尝试 接收 邮件 。 
STEP3 判断 本 次 接收 邮件 操作 是 否 成 功 ， 如 果 成 功 ， 则 转 到 STEP11。 
STEP4 如 果 没有 成 功 ， 则 需要 检查 本 次 操作 是 不 是 阻塞 模式 。 如 有 果 不 是 ， 则 直接 返回 。 


STEP5 如 果 是 ， 则 判断 内 核 是 否 关闭 了 线程 调度 。 





STEP6 如 果 是 ， 则 此 时 需要 保存 本 次 操作 的 信息 到 线程 相关 结构 ， 并 将 自己 阻塞 在 邮箱 的 线程 阻塞 队列 。 

STEP7 向 内 核发 出 线程 调度 请 求 。 

STEP8 ”内核 退出 独占 区 ， 因 为 是 在 线程 环境 下 ， 退 出 后 极 有 可 能 发 生 线 程 调度 ， 除 非 此 时 有 ISR 及 时 发 生 并 且 发 送 了 邮件 ; 如 果 发 生 了 调度 ， 当 前 线程 被 阻塞 ， 直 到 被 再 次 唤醒 。 
STEP9 线程 被 唤醒 并 且 调 度 执行 ， 在 这 里 立刻 使 得 内 核 进入 独占 区 。 

STEP10 读 取 本 次 接收 邮件 操作 的 结果 ， 随 后 清空 当前 线程 的 IPC 缓 存 信息 。 

STEP11 如 果 在 STEP4 成 功 读 取 邮件 ， 则 需要 检查 在 读 取 邮件 的 时 候 是 否 唤醒 了 比 当前 线程 优先 级 更 高 的 线程 ， 如 果 没 有 ， 则 退出 函数 。 

STEP12 如 果 有 ， 则 需要 检查 内 核 此 时 是 否 关闭 了 线程 调度 。 如 果 是 ， 则 退出 函数 。 

STEP13 ”向 内 核发 出 线程 调度 请 求 。 


STEP14 ”结束 返回 。 

















从 图 6-9 中 可 以 看 出 ， 在 线程 接收 邮件 的 获取 时 ， 首 先 会 尝试 一 下 ， 在 尝试 的 过 程 中 可 能 成 功 也 可 能 失败 (在 成 功 的 时 候 ， 有 可 能 唤醒 了 阻塞 在 邮箱 上 的 线程 ， 而 被 唤醒 的 这 个 线程 的 优先 级 可 能 比 当前 
线程 更 高 ) ， 然 后 再 根据 尝试 的 结果 进行 以 下 操作 : 失败 了 可 能 需要 把 自己 阻塞 ; 成 功 了 有 可 能 需要 进行 线程 调度 。 这 上段 代码 的 核心 逻辑 就 在 这 里 。 该 函数 的 类 C 伪 代码 如 代码 清单 6-5 所 示 。 

















代码 清单 6-5: 邮件 接收 代码 演示 





Te 
线程 接收 邮件 
2. { 


3 
尝试 从 邮箱 读 取 邮 件 ; 


4. 
成 功 读 取 邮 件 ) 
5. { 


6. 汪 关 人 
有 更 高 优先 级 线程 被 唤醒 ) 
并 且 ( 
站 术 没 和 有 大 轩 成 但 山 太 ) ) 

- { 


8. 

申请 线程 调度 7 

9. } 
10. } 

Pls else 
12: { 


六 和 人 
线程 以 阻塞 方式 来 接收 邮件 ) 
并 且 ( 

内 核 没有 关闭 线程 调度 ) ) 
14. { 






线程 IPC 

息 ; 

得 阻 塞 在 该 邮箱 的 阻塞 队列 ; 
前 线程 申请 调度 ; 


8. 
打开 系统 中 断 ; 
19. 于 


此 时 此 处 非常 有 可 能 发 生 一 次 调度 ， 除 非 线程 调度 请 求 被 内 核 取消 
24。 

人 从 本 处 继续 运行 。 

22。 et 








23: 

再 次 关闭 系统 中 断 ; 

24. 

获得 对 邮箱 进行 操作 的 结果 ; 
> 








3. 尝试 接收 邮件 函数 





出] 


尝试 接收 邮件 函数 的 流程 图 如 图 6-10 所 示 。 

















流程 图 分 析 : 


STEP2 


STEP3 


STEP4 


STEP5 


STEP6 


检查 邮箱 状态 是 不 是 满 ， 如 果 不 是 ， 则 返回 失败 。 
如 果 邮 箱 满 ， 则 从 邮箱 中 读 取 邮 件 。 
尝试 从 信号 量 的 线程 阻塞 队列 中 唤醒 一 个 线程 。 
判断 是 不 是 真 的 唤醒 了 一 个 线程 。 


如 果 是 ， 则 将 该 线程 的 邮件 发 往 邮箱 。 


图 6-10 


尝试 接收 邮件 函数 的 流程 图 


STEP7 如 果 不 是 ， 则 清空 邮箱 ， 设 置 状态 为 空 。 


STEP8 结束 返回 。 











从 图 6-10 中 可 以 看 出 ， 在 尝试 读 取 邮件 时 ， 并 不 区 分 被 线程 调 














伪 代 码 描述 如 代码 清单 6-6 所 示 。 


代码 清单 6-6: 尝试 接收 邮件 代码 演示 


























还 是 被 ISR 调 用 。 这 个 函数 主要 是 操作 上 邮箱。 邮箱 为 空 时 是 不 能 成 功 读 取 邮件 的 ;而 邮箱 为 满 时 有 可 能 存在 被 阻塞 的 线程 。 该 函数 的 类 C 














访 
党 
如 
Pe: 
如 


前 线程 从 邮箱 中 读 取 邮 件 ; 

箱 的 线程 阻塞 队列 中 唤醒 一 个 合适 的 线程 ; 
了 

有 线程 被 唤醒 ) 
as 


张 账 个 可 久 
于 并 
让 
加 


喜 
王 


线程 待 发 送 的 邮件 发 给 邮箱 ; 
10. 

保持 邮箱 状态 不 变 ; 

11. 


} 
1&。 else 
hi { 


14, 
设置 邮件 为 空 ; 

15: 

设置 邮箱 状态 为 空 ; 
16. } 





将 该 


下 7。 

结果 为 成 功 ; 

18. 

Lg else 


21; 
结果 为 失败 ; 
22. 


23. 
返回 结果 ; 
24. } 





6.2.4 发 送 邮件 


邮件 的 发 送 操作 主要 是 由 以 下 几 个 函数 来 完成 的 。 





“发送 邮件 接口 函数 xMailboxSend () : 该 函数 是 邮箱 模块 向 外 提供 的 接口 函数 ， 被 内 核 API 函 数 调用 。 它 根据 操作 模式 这 个 参数 来 区 分 处 理 本 次 邮件 发 送 的 操作 。 根 据 操作 模式 的 不 同 ， 操 作 可 以 分 为 
线程 模式 和 ISR 模 式 ， 不 可 以 进一步 细 分 为 线程 阻塞 方式 〈 无 限期 和 时 限 ) 、 线 程 立刻 返回 和 ISR 立 刻 返 回 3 种 模式 。 另 外 由 该 函数 完成 和 邮箱 相关 的 内 核 数据 的 保护 工作 。 


“ 线程 发 送 邮 件 函 数 ThreadSendMail () : 该 函数 实现 了 线程 发 送 邮 件 的 核心 远 辑 。 它 首先 会 通过 函数 TrySendMail () 尝试 向 邮箱 中 发 送 邮 件 ， 然 后 根据 结果 来 继续 操作 。 后 继 操作 包括 成 功 后 的 线程 调 


度 检查 和 失败 后 的 线程 阻塞 操作 都 是 在 这 里 完成 的 。 


"ISR 发送 邮件 函数 IstrSendMail () : 该 函数 比较 简单 。 因 为 在 用 户 ISR 里 不 会 有 线程 调度 的 问题 (线程 调度 的 逻辑 在 ISR 返 回 时 由 内 核 处 理 ) 。 它 同 线程 发 送 邮 件 函 数 一 样 ， 同 样 是 调用 TrySendMail () 


“ 尝试 发 送 邮 件 函 数 TrySendMail () : 这 个 函数 是 发 送 邮 件 的 核心 部 分 ， 它 会 根据 邮箱 的 状态 来 处 理 本 次 请 求 。 


“ 如果 邮 箱 的 状态 为 满 ， 则 直接 返回 失败 。 


“ 如 果 邮 箱 的 状态 为 空 ， 则 需要 检查 邮箱 的 线程 阻塞 队列 是 否 有 线程 存在 。 


“ 如 果 有 ， 说 明 此 时 那些 被 阻塞 的 线程 ， 都 是 因为 邮箱 为 空 而 不 能 接收 邮件 的 线程 ， 所 以 本 次 发 送 邮件 操作 不 会 对 邮箱 状态 有 任何 影响 。 只 需要 在 全 部 阻塞 线程 中 找到 一 个 合适 的 线程 并 唤醒 ， 并 把 


邮件 发 送 给 该 线程 。 


“ 如 果 没 有 ， 则 需要 发 邮件 到 邮箱 中 ， 并 且 设 置 邮箱 状态 为 满 。 





这 几 个 函数 的 层次 关系 比较 简单 。 注 意 xMailboxSend () 起 到 的 是 分 发 调用 的 作 
































， 函 数 ThreadSendMail () 和 IsrSendMail () 是 不 同 运行 环境 下 的 具体 操作 函数 ， 而 TrySendMail () 则 主要 是 


操作 邮箱 对 象 。 这 几 个 函数 的 流程 如 图 6-11 至 图 6-13 所 示 。 函 数 lsrSendMail () 的 实现 很 简单 ， 就 不 再 详细 分 析 了 。 

















1. 发 送 邮件 接口 函数 








风 


发 送 邮件 接口 函数 的 流程 图 如 图 6-11 所 示 。 




















4ISR 发 送 邮件 5 线程 发 送 邮件 


6 内 核 退出 独占 区 





7 返回 











习 6-11 发送 邮 件 接口 函数 流程 图 





流程 图 分 析 : 


STEP2 内 核 进 入 独占 区 。 


STEP3 判断 是 不 是 ISR 来 发 送 邮件 。 


STEP4 如 果 是 ， 则 调用 ISR 发 送 邮 件 函 数 。 


STEP5 如 果 不 是 ， 则 调用 线程 发 送 邮 件 函 数 。 


STEP6 ”内核 退出 独占 区 。 


STEP7 函数 返回 。 





从 图 6-11 中 可 以 看 出 ， 这 个 函数 只 是 个 接口 函数 ， 只 是 根据 操作 类 型 判断 下 一 步 该 怎么 执行 。 














2. 线程 发 送 邮件 函数 





线程 发 送 邮件 函数 的 流程 图 如 图 6-12 所 示 。 




















流程 图 分 析 : 











STEP2 当前 线程 尝试 发 送 邮件 。 

STEP3 判断 本 次 发 送 邮 件 操作 是 否 成 功 ， 如 果 是 ， 则 转 到 STEP13。 

STEP4 如 果 没 有 成 功 ， 则 需要 检查 本 次 操作 是 不 是 阻塞 模式 。 

STEP5 如 果 是 ， 则 判断 内 核 是 否 允 许 线程 调度 。 

STEP6 ”如果 允许 ， 则 判断 发 送 的 是 否 为 紧急 邮件 。 

STEP7 如 果 是 ， 则 在 线程 的 IPC 记 录 中 标明 紧急 邮件 ， 将 要 使 用 邮箱 的 辅助 线程 阻塞 队列 。 

STEP8 此 时 需要 保存 本 次 操作 的 信息 到 线程 IpcRecord 结 构 ， 并 将 自己 阻塞 在 邮箱 的 线程 阻塞 队列 中 。 
STEP9 向 内 核发 出 线程 调度 请 求 。 

STEP10 内 核 退 出 独占 区 ， 因 为 是 在 线程 环境 下 ， 退 出 后 极 有 可 能 发 生 线 程 调 度 ， 除 非 此 时 有 ISR 及 时 发 生 并 且 发 送 了 邮件 ; 如 果 发 生 了 调度 则 当前 线程 被 阻塞 ， 直 到 被 唤醒 。 
STEP11 线程 被 唤醒 并 且 再 次 执行 ， 在 这 里 立刻 使 得 内 核 进入 独占 区 。 

STEP12 读 取 本 次 发 送 邮 件 操作 的 结果 ， 随 后 清空 当前 线程 的 IPC 缓 存 信息 。 

STEP13 如果 在 STEP3 成 功 发 送 邮 件 ， 则 需要 检查 在 读 取 邮件 时 是 否 唤醒 了 比 当前 线程 优先 级 更 高 的 线程 。 
STEP14 如 果 是 ， 则 需要 检查 内 核 此 时 是 不 是 允许 线程 调度 。 

STEP15 如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 


STEP16 ”函数 返回 。 


10 内 核 退出 独占 区 





图 6-12 ”线程 发 送 邮件 函数 流程 图 





从 上 面 的 流程 中 可 以 看 出 ， 在 线程 发 送 邮件 的 获取 时 ， 首 先 会 尝试 一 下 ， 在 尝试 的 过 程 中 可 能 成 功 也 可 能 失败 (在 成 功 的 时 候 ， 有 可 能 唤醒 了 阻塞 在 邮箱 上 的 线程 ， 而 被 唤醒 的 这 个 线程 的 优先 级 可 能 
比 当前 线程 更 高 ) ， 然 后 再 根据 尝试 的 结果 进行 以 下 操作 : 失败 了 可 能 需要 把 自己 阻塞 ;成功 了 有 可 能 需要 进行 线程 调度 。 该 函数 的 类 C 伪 代码 如 代码 清单 6-7 所 示 。 


代码 清单 6-7: 发 送 邮 件 代码 演示 





TE 
线程 发 送 邮 件 


2. { 

3 

尝试 发 送 邮 件 ; 

4. if ( 
邮件 发 送 成 功 ) 

5. { 


6. if (( 
全 机 外 多 租约 和 和 守卫 
( 
内 以 没有 关闭 线 各 加 度 ) ) 
. { 


8. 

申请 线程 调度 ; 

9. } 
10. } 

Ls else 
la 4 


线程 以 阻塞 方式 来 接收 邮件 ) 


且 
内 核 没有 关闭 线程 调度 ) ) 
14. 


15s 
如 果 是 紧急 邮件 则 在 线程 IPC 
记录 中 标明 





17. 

当前 线程 阻塞 在 该 邮箱 的 阻塞 队列 ， 
18. 

当前 线程 申请 调度 ; 
19; 

打开 系统 中 断 ; 
20. 


/x* 
21. 
此 时 此 处 非常 有 可 能 发 生 一 次 调度 ， 除 非 线程 调度 请 求 被 内 核 取消 ; 


22。 
当 处理 器 再 次 处 理 本 线程 时 ， 从 本 处 继续 运行 。 
23. wh 


24. 

下 次 关闭 系统 中 断 ， 

获得 对 邮箱 进行 操作 的 结果 ; 
26 . 











3. 尝试 发 送 邮 件 函 数 





尝试 发 送 邮件 函数 的 流程 图 如 图 6-13 所 示 。 














流程 图 分 析 : 











STEP2 检查 邮箱 状态 是 否 为 空 ， 如 有 果 不 是 ， 则 返回 失败 。 


STEP3 ”尝试 从 邮箱 的 线程 阻塞 队列 中 唤醒 一 个 线程 。 


STEP4 判断 是 否 真 的 唤醒 了 一 个 线程 。 


STEP5 如 果 是 ， 则 将 邮件 发 到 该 线程 。 


STEP6 如 果 没有 ， 则 将 邮件 发 到 邮箱 ， 置 邮箱 状态 为 满 。 


STEP7 函数 返回 。 


4 线程 唤醒 成 功 ? 


5 将 邮件 直接 6 将 邮件 发 给 邮 
发 给 该 线程 箱 置 邮 箱 状态 为 满 





图 6-13 ”尝试 发 送 邮件 函数 流程 图 


从 图 6-13 中 可 以 看 出 ， 在 尝试 发 送 邮件 时 ， 并 不 区 分 是 被 线程 调用 还 是 被 |SR 调 用 。 这 个 函数 主要 是 操作 邮箱 ， 邮 箱 为 满 时 是 不 能 继续 发 送 邮件 的 ; 邮箱 为 空 时 有 可 能 存在 阻塞 的 线程 。 该 函数 的 类 (C 伪 
代码 如 代码 清单 6-8 所 示 。 








代码 清单 6-8: 尝试 发 送 邮 件 代码 演示 





Is 
尝试 向 邮箱 发 送 邮 件 
区 { 
号 六 
拓 逢 杖 

四 { 


Ss 

兰 城 从 抒 箱 的 总 各 用 举 队 列 让 也 曲 一 个 合 汪 的 二 得: 
i 

宙 二 各 被 喘 用 ) 


8. 

痢 当 前 线程 竺 发 送 的 邮件 发 送 给 被 唤醒 的 线程; 
保持 邮箱 状态 不 变 ; 

10, } 


LE else 
12s 下 


.3 
将 当前 线程 待 发 送 的 邮件 发 送 给 邮箱 ; 
4 


4s 
设置 邮箱 状态 为 满 ; 
5 } 





6.2.5 ”终止 线程 阻塞 


线程 阻塞 在 邮箱 的 线程 阻塞 队列 时 ， 可 以 是 无 限期 的 阻塞 直到 对 邮箱 的 操作 成 功 ; 或 者 是 有 期 限 的 等 待 ， 在 期 限 到 达 时 如 果 仍然 无 法 成 功 则 自动 退出 阻塞 。 这 里 的 终止 邮箱 阻塞 线程 的 操作 则 是 由 外 部 
强制 线程 解除 阻塞 ， 提 供 了 另 一 种 方式 结束 线程 对 邮箱 的 等 待 。 其 流程 图 如 图 6-14 所 示 。 

















1 开始 


2 内 核 进 入 独占 区 


3 终止 该 线程 在 


邮箱 线程 阻 窜 队 列 上 
的 阻 禾 














4 该 线程 优 
级 比 当前 线程 
先 级 高 ? 


5 内 核 允 许 线程 调度 ? 






6 咀 数 被 线程 调用 ? 


AI DA WA VI I4 » 


7 申请 线程 调度 


8 内 核 退 出 独占 区 





图 6-14 ”解除 线程 阻塞 函数 流程 图 
流程 图 分 析 : 
STEP2 内 核 进 入 临界 区 。 
STEP3 将 线程 从 邮箱 的 线程 阻塞 队列 中 解除 阻塞 。 该 函数 会 检查 指定 的 线程 是 否 阻塞 在 邮箱 的 线程 阻塞 队列 中 。 
STEP4 判断 被 解除 阻塞 的 线程 的 优先 级 是 不 是 比 当前 线程 的 优先 级 高 。 
STEP5 判断 此 时 函数 是 不 是 被 线程 调用 。 
STEP6 判断 此 时 内 核 是 不 是 关闭 了 线程 调度 。 
STEP7 向 内 核发 出 线程 调度 请 求 。 
STEP8 内 核 退 出 独占 区 。 


STEP9 函数 返回 。 


6.2.6 ”邮箱 刷新 





邮箱 刷新 和 邮箱 取消 初始 化 很 像 ， 区 别 在 于 取消 初始 化 邮箱 操作 会 导致 清空 邮箱 的 线程 阻塞 队列 ， 还 把 邮箱 设置 成 进入 非 初始 化 状态 ， 不 能 继续 使 用 。 如 果 希 望 继 续 使 用 则 只 能 再 次 初始 化 ; 而 邮箱 刷 
新 则 只 是 将 邮箱 线程 阻塞 队列 上 的 线程 全 部 唤醒 ， 这 样 的 邮箱 就 像 刚 被 初始 化 后 的 情形 ， 可 以 继续 使 用 。 邮 箱 刷新 函数 的 流程 图 如 图 6-15 所 示 。 


1 开始 














2 内 核 进入 独占 区 









8 内 核 退 出 独占 区 


STEP2 内核 进入 临界 区 。 

STEP3 ”邮箱 的 线程 阻塞 队列 清空 ， 唤 醒 全 部 被 阻塞 的 线程 。 保 持 邮 箱 的 就 绪 属 性 。 

STEP4 检查 在 清空 邮箱 的 线程 阻塞 队列 时 是 否 唤醒 了 比 当前 线程 优先 级 更 高 的 线程 。 

STEP5 ”如果 是 ， 则 判断 内 核 是 否 允许 线程 调度 。 

STEP6 如 果 是 ， 则 判断 该 函数 是 否 被 线程 调用 。 

STEP7 如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 

STEP8 ”内核 退出 独占 区 ， 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP9 函数 返回 。 


6.2.7 ”邮箱 广播 








当 有 多 个 任务 因为 不 能 接收 到 邮件 而 阻塞 在 邮箱 时 ， 可 以 通过 广播 方式 向 这 些 任务 发 送 相同 的 邮件 ， 完 成 多 任务 的 同步 和 通信 。 邮 箱 广 播 函数 的 流程 图 如 图 6-16 所 示 。 














2 内 核 进入 独占 区 





流程 图 分 


STEP2 


STEP3 


STEP4 


STEP5 


STEP6 


STEP7 


STEP8 


STEP9 


芯 


9 内 核 退 出 独占 区 


10 返回 


图 6-16 ”邮箱 广播 函数 流程 图 














析 : 

内 核 进 入 临界 区 。 

检查 邮箱 状态 是 否 为 室 ， 如 果 不 为 室 ， 则 直接 退出 。 

把 邮箱 的 线程 阻塞 队列 清空 ， 解 除 全 部 线程 的 阻塞 并 向 这 些 线程 发 送 同样 的 邮件 。 保 持 邮 箱 的 就 绪 属 性 。 
检查 在 清空 邮箱 的 线程 阻塞 队列 时 是 否 唤醒 了 比 当前 线程 优先 级 更 高 的 线程 。 

如 果 是 ， 则 判断 内 核 是 否 允 许 线程 调度 。 

如 果 是 ， 则 检查 该 函数 是 否 被 线程 调用 。 

如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 


内 核 退 出 独占 区 ， 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP10 ”函数 返回 。 





6.3 ”邮箱 应 用 演示 








下 面 结合 实例 介绍 一 些 邮 箱 常见 的 典型 用 法 。 








6.3.1 ”线程 间 的 异步 数据 传输 





在 本 例 中 ， 邮 件 被 定义 为 LED 的 控制 命令 。 然 后 两 个 线程 通过 邮箱 发 送 和 接收 邮件 ， 从 而 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 其 中 主 控 线 程 不 停 地 以 非 阻塞 方式 发 送 邮件 ， 每 次 发 送 邮件 成 功 后 延 时 1 
秒 ; LED 线 程 则 不 停 地 以 阻塞 方式 党 试 接收 邮件 ， 然 后 根据 邮件 的 内 容 ， 即 LED 控 制 命令 来 点 亮 或 者 熄灭 [ED， 循 环 往复 。 


在 这 个 例 程 里 ，LED 线 程 和 主 控 线 程 的 数据 传输 是 单 向 的 ， 并 且 是 异步 的 。 即 主 控 线 程 的 运行 不 依赖 LED 线 程 ; 而 LED 线 程 的 执行 则 依赖 于 主 控 线 程 发 送 的 邮件 。 程 序 实现 如 代码 清单 6-9 所 示 。 








代码 清单 6-9: 邮箱 应 用 例 程 1 





1, #include 

“example.h 

” 

和 26 #include 

“trochili.h 

也 

3 

4. #if (EVB EXAMPLE 一 CH6 MAILBOX EXAMPLE1) 
8 


6. /* 
用 户 线程 参数 */ 
Rs #define THREAD LED STACK SIZE (256) 


gs #define THRFEAD LED PRIORITY (5) 
9. #qefine THREAD LED SLICE (20) 
10. 

11. #qdefine THREAD CTRL STACK SIZE (256) 
2 #define THREAD CTRL PRIORITY (6) 
13: #define THREAD CTRL SLICE (20) 
14. 


15。 他 
用 户 线 程 定义 */ 
16 static TThread ThreadLED; 


Ts static TThread ThreadCTRL; 

18: 

9 Pi 

用 户 线程 栈 定义 */ 

-Ab static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
巧 和 static TWord ThreadCcTRLStack[THREAD CTRL STACK SIZE]; 
22。 

23。 

24. J 

用 户 邮件 类 型 定义 */ 

25. typedef struct 

26. { 

这 TIndex Index; 

28 . TByte Value 

2 } TLEDMail; 

30. 

31. 


32。 区 
用 户 邮 箱 和 邮件 定义 */ 
3 static TMailBox LEDMailbox; 

















34. static TLEDMail LEDMail; 

35。 

36 . /* LED 

线程 的 主 函 数 */ 

37 static void ThreadLEDEntry (void* pArg) 
38. { 

3 TErrno errno; 

40. TState state; 

41. TLEDMail* pMail; 

42. 

43. while (eTrue) 

44. h 

a5 state = TclReceiveMail (&LEDMailbox, (TMail*) (gpMail), 
46. IPC OPT WAIT, 0, &errno); 
47. if (state == eSuccess) 

48 . 

49. EVB LEDControl (pMail->Index, PMail->Value); 
50 . } 

Sh } 

32 } 

53. 

54. /* 

主 控 线程 的 主 函 数 */ 

35s static void ThreadCTRLEntry (void* pArg) 
56. { 

Es TErrno errno; 

58. TLEDMail* pMail = &LEDMail; 

3 

60 . while (eTrue) 

61. h 

62 2 





控制 线程 通过 邮箱 发 送 LED 
点 亮 邮件 ， 采 用 非 阻塞 方式 发 送 */ 


63. LEDMail.Index = LED17 

64. PMail->Value = LED ON; 

65. TclSendMail (&LEDMailbox, (TMail*) (&pMail), 

66. IPC OPT WAIT, 0, &errno); 

67. ee 

68 . 

控制 线程 延 时 1 

秘 -*y 

69 . TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) ， 
70. 


I i 
控制 线程 通过 邮箱 发 送 LED 
熄灭 邮件 ， 采 用 非 阻塞 方式 发 送 */ 





12, LEDMail.TIndex = LED17 

3 PMail->Value = LED OFF; 

74. TclSendMail (gLEDMailbox, (TMail*) (gpMail), IPC OPT WAIT, 0, &errno); 
了 5。 

76 . Wi 

控制 线程 延 时 1 

秒 */ 

7 TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 
78. } 

79 } 

80 . 

81. a 

用 户 应 用 程序 入 口 函数 */ 

82. static void APP LEDEnNtry (void) 

83. { 

84. TErrno errno; 

85. 


86. /* 
配置 使 能 评估 板 上 的 LED 
设备 */ 


87. EVB_LEDConfig () 7 

88 . 

89. TclInitMailBox (&LEDMailbox, IPC PROP NONE, &errno); 
90 . 

91 . Po 

初始 化 LED 

设备 控制 线程 */ 

92. TclInitThread(&ThreadLED, &ThreadLEDENntry, (void*)NULL, 
93. ThreadLEDStack, THREAD LED STACK SIZE, 
94. THREAD LED PRIORITY, THREAD LED SLICE); 
95, 

96. Ci 

初始 化 CTRL 

线程 */ 

97. TclInitThread(&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
98 . ThreadCTRLStack, THREAD CTRL STACK SIZE, 
99。 THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
100. 

101. 

激活 LED 

线程 */ 

102. TclActivateThread (&ThreadLED); 

103. 

104. 

激活 主 控 线程 */ 

Sn TclActivateThread (&ThreadCTRIL) 7 

106. } 

107。 

108. 

E09. /* 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

110. int main(void) 

Til 


2 
注册 处 理 器 初始 化 函数 到 内 核 */ 
E13: TclSetCpuEntry (&CPU_STM32F10xInit); 





5。 
注册 板 级 初始 化 函数 到 内 核 */ 
116 . TclSetBoardEntry (&EVB SetupBoard) 7 


Le 
注册 板 级 调试 打印 函数 到 内 核 */ 
119, TclSetTraceRoutine (&EVB UartlWriteString); 








> js 
注册 用 户 初始 化 函数 到 内 核 */ 
1 TclSetUserEntry (&APP LEDENtry); 


124. A 

启动 内 核 */ 

T2535a TclStartKernel (); 
126, 

Tey return 1; 

128.。 } 

29 

130. #endif 








程序 运行 后 ，LED 的 变化 如 图 6-17 所 示 。 
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6-17 LED 的 变化 情况 














6.3.2 ”线程 和 ISR 间 的 异步 数据 传输 


在 本 例 中 邮件 被 定义 为 LED 的 控制 命令 。 然 后 一 个 LED 线 程 从 邮箱 中 接收 邮件 ， 邮 件 的 内 容 决定 LED 的 点 亮 或 者 熄灭 。 用 户 通过 外 部 按键 中 断 来 激活 KeylSR， 在 该 ISR 中 ， 会 交 蔡 发 送 LED 点 亮 和 熄灭 的 
邮件 ， 从 而 实现 LED 按 照 用 户 按键 的 操作 点 亮 和 熄灭 。 




















在 这 个 例 程 里 ，LED 线 程 和 KeylSR 的 数据 传输 是 单 向 的 ， 并 且 是 异步 的 。LED 线 程 的 执行 则 依赖 于 KeylSR， 而 KeylSR 的 运行 是 不 确定 的 。 程 序 实现 如 代码 清单 6-10 所 示 。 


代码 清单 6-10: 邮箱 应 用 例 程 2 





Ls #include 

“example.h 

加 

2。 #include 

“trochili.h 

也 

3 

4. #if (EVB EXAMPLE == CH6 MAILBOX EXAMPLE2) 


5 #include 
»evb ) bsp.h 


/* 
户 线程 参数 */ 
#define THREAD LED STACK SIZE (256) 


; #qdefine THREAD LED PRIORITY (5) 
0. #qdefine THREAD LED SLICE (20) 
1 
2， 

加 定义 */ 


static TThread ThreadLED; 


a 


/* 
日 户 线程 栈 定义 */ 


汝 PIR oH 











6. static TWord ThreadLEDStack{[THREAD LED STACK SIZE]; 
7. 

8. 

, 

目 户 邮件 类 型 定义 */ 
20. typedef struct 
Es 下 
六 TIndex Index; 
3 TByte Value; 
24. } TLEDMail; 
25. 
2 


A oti 人 
static TMailBox LEDMailbox; 





2 static TLEDMail LEDMail; 
30. 

La /* LED 

线程 的 主 函数 */ 

2 static void ThreadLEDEntry (void* pArg) 
33. { 

34. TErrno errno; 

:< 

3 TState state; 

a TLEDMail* pMail; 
38. 

9 while (eTrue) 

pe t 


入 了 六 式 ci 2 
state = TclReceiveMail (&LEDMailbox， (TMail*) (&PMail)， 
IPC OPT WAIT, 0, &errno); 
44. if (state == eSuccess) 
45. { 
46. EVB_LEDControl (pMail->Index, pMail->Value); 
47. } 
48. } 
49. } 
0 


主义 A 
static void EVB KeyISR (TVector vector, TProferty Property, TWord data) 


33: { 
54. TLEDMail* pMail = &LEDMail; 
Fede static int turn = 0; 
56. 
S73; LEDMail.Index = LED17 
58. if (EVB KeyScan()) 
2 { 
* 
针 伯 内容 交 将 ON 
和 OFF*/ 
I, turnt+; 
62 . PMail->Value = (turn % 2) ? LED ON : LED OFF; 


/* Key ISR 
Dim 2 
TclIsrSendMail (&LEDMailbox， (TMail*) (gpMail), 0); 

Ce: } 
67. } 
人 

/* 
必 户 应 有 查证 入 口 要 SF 

static void APP LEDEnNtry (void) 
和 和 { 
32 TErrno errno; 


Pin 
配置 使 能 评估 板 上 的 LED 


设备 */ 
区 EVB_ LEDConfig () 7 
6 EVB_KeyConfig () 7 


了 8。 Li 

设置 和 KEY 

相关 的 外 部 中 断 向 量 */ 

3 TclSetIntVector (KEY_INT VECTOR, &EVB KeyISR, 0); 


81. /* 
初始 化 邮箱 */ 
Se TclInitMailBox (&LEDMailbox, IPC PROP NONE, &errno); 


84. 
初始 化 LED 

设备 控制 线程 */ 
35 TclInitThread(&ThreadLED, &ThreadLEDENntry, (void*)NULL, 
86. ThreadLEDStack, THREAD LED STACK SIZE, 
87. THREAD LED PRIORITY, THREAD LED SLICE); 
88. 
89. 
激活 LED 

设备 控制 线程 */ 
90 TclActivateThread (&ThreadLED); 








81.: } 
92. 

93 . 

94 . /* 
处 理 器 BOOT 

之 后 会 调用 main 
函数 ， 必 须 提供 */ 

95 . int main (void) 
96. { 


2 
注册 处 理 器 初始 化 函数 到 内 核 */ 
9 TclSetCpuEntry (&CPU_STM32F10xInit) 7 


i 
注册 板 级 初始 化 函数 到 内 核 */ 
0 TclSetBoardEntry (&EVB_SetupBoard); 


sw 
注册 板 级 调试 打印 函数 到 内 核 */ 
104. TclSetTraceRoutine (&EVB Uart1lWriteString); 





3 
注册 用 户 初始 化 函数 到 内 核 */ 
A TclSetUserEntry (&APP LEDENtry); 


二 1 有 return 1; 
于 3 

114. 

115. 

116. #endif 

















该 例子 运行 结果 不 方便 图 示 ，LED 灯 会 随 着 用 户 键 的 按 下 不 停 地 点 亮 或 熄灭 。 




















6.3.3 ”线程 间 的 单 向 同步 数据 传输 





在 本 例 中 邮件 被 定义 为 LED 的 控制 命令 。 然 后 两 个 线程 通过 邮箱 发 送 和 接收 邮件 ， 从 而 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 不 过 和 前 面 的 例子 不 同 的 是 ， 增 加 了 一 个 信号 量 进 行 两 个 线程 的 同步 。 其 中 
主 控 线程 不 停 地 以 非 阻塞 方式 发 送 邮件 ， 每 次 发 送 邮件 成 功 后 则 停止 运行 ， 然 后 等 待 信号 量 ; LED 线 程 则 不 停 地 以 阻塞 方式 尝试 接收 邮件 ， 然 后 根据 邮件 的 内 容 ， 即 LED 控 制 命令 来 点 亮 或 者 熄灭 LED。 只 有 
当 LED 线 程 释放 信号 量 后 控制 线程 才能 继续 运行 。 


在 这 个 例 程 里 ，LED 线 程 和 主 控 线 程 的 数据 传输 是 单 向 的 ， 但 运行 却 是 同步 的 。 即 主 控 线 程 的 运行 依赖 LED 线 程 释放 信号 量 ; 而 LED 线 程 的 执行 则 依赖 于 主 控 线 程 发 送 的 邮件 。 程 序 实现 如 代码 清单 6-11 
所 示 。 





代码 清单 6-11: 邮箱 应 用 例 程 3 





二 #include 

“example.h 

” 

和 2。 #include 

"Erochili .kh 

六 

人 

4. #if (EVB EXAMPLE 一 CH6 MAILBOX FEXAMPLE3) 
Ss 

5 

用 户 线程 参数 */ 

Es #define THREAD LED STACK SIZE (256) 
8. #define THREAD LED PRIORITY (5) 
9 #define THREAD LED SLICE (20) 
10. 

了 #define THREAD CTRL STACK SIZE (256) 
12。 #define THREAD CTRL PRIORITY (6) 
IT3。 #define THREAD CTRL SLICE (20) 
14. 


15. * 
用 户 线程 定义 */ 
6 static TThread ThreadLED; 


LT static TThread ThreadCTRL;7 

18: 

TS 

用 户 线程 栈 定义 */ 

2 static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 

六 1。 static TWord ThreadCTRLStack [THREAD CTRL STACK SIZE]; 
22。 


23: 
用 户 邮件 类 型 定义 */ 
24 typedef struct 


25. { 

这 6v TIndex Index; 
27. TByte Value; 
28. } TLEDMail; 

9 

30 . 


31。 A 
用 户 邮箱 、 邮 件 和 信号 量 定义 */ 
EE static TMailBox LEDMailbox; 





33. static TLEDMail LEDMail; 
34. static TSemaphore LedSemaphore; 
35; 
36. /* LED 
线程 的 主 函 数 */ 
ls static void ThreaqLEDEntry (void* pArg) 
38. { 
3 TErrno errno; 
40. TState state; 
41. TLEDMail* pMail; 
42. 
43. while (eTrue) 
44. { 
45. /* LED 
线程 以 阻塞 方式 接收 邮件 */ 
46. state = TclReceiveMail (&LEDMailbox, (TMail*) (&PMail)， 
47. IPC OPT WAIT, 0, &errno); 
48. if (state == eSuccess) 
49. { 
50. /* LED 
空 制 LED 






和 熄灭 */ 
51. EVB_LEDControl (pMail->Index, pMail->Value); 


53. /* LED 

线程 延 时 1 

秒 */ 

54. TclDelayThread (uThreaqdCurrent，MLS2TICKS (1000) ) 7 
5 


56. 
线程 释放 信号 量 */ 
57。 


58 . } 
59. } 

60. 】 

61. 

62. 了 
E 控 线程 的 主 函 数 */ 


/* LED 


TclReleaseSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 

















63 static void ThreadCTRLENtry (void* pArg) 
64. { 

65; TErrno errno; 

66. TLEDMail* pMail = &LEDMail; 

67. 

68 . while (eTrue) 

69. { 

70. Py 

控制 线程 以 非 阻塞 方式 发 送 控制 LED 

点 亮 的 邮件 */ 

14 pMail->Value = LED ON; 

78: PMail->Index = LEDT; 

73. TclSendMail (gLEDMailbox, (TMail*) (gpMail), 0, 0, &errno); 


74. 


75。 is 

控制 线程 以 非 阻 塞 方式 获取 信号 量 */ 

16 TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
了 7 


78. /* 

控制 线程 以 非 阻塞 方式 发 送 控制 LED 
熄灭 的 邮件 */ 

79. PMail->Value = 
80. PMail->Index = 


81。 TclSendMail (&LEDMailbox, (TMail*) (gpMail), 0, 0, &errno); 
82. 


3. A 

控制 线程 以 阻塞 方式 获取 信号 量 */ 

84. TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 
5 } 

86. } 

87. 

88. 


89. 

用 户 应 用 程序 入 口 函数 */ 

90 . static void APP LEDEntry (void) 
91. . 

92. TErrno errno; 

93: 

94. i 

配置 使 能 评估 板 上 的 LED 

设备 */ 

95 . EVB LEDConfig () 7 

96 . 
97。 i 

初始 化 信号 量 和 邮箱 */ 

98 . TclInitMailBox (&LEDMailbox, IPC PROP NONE, &errno); 

99., TclInitSemaphore (&LedSemaphore, 0, 1, IPC PROP NONE, &errno); 
100. 
101. /* 

初始 化 LED 

设备 控制 线程 */ 

102. TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
103: ThreadLEDStack, THREAD LED STACK SIZE, 
104. THREAD LED PRIORITY, THREAD LED SLICE); 
105. 
106. 下 

初始 化 CTRL 

线程 */ 

i07s TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
108. ThreadCTRLStack, THREAD CTRL STACK SIZE, 
109. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
110. 

Ts 人 

激活 LED 

线程 */ 

112. TclActivateThread (&ThreadLED); 

113: 

114. Ey 

激活 主 控 线程 */ 

L153 TclActivateThread (&ThreadCTRL); 

116. } 















调用 main 

， 必 须 提 供 */ 

。int main (void) 

2 

处 理 器 初始 化 函数 到 内 核 */ 

‘ TclSetCpuEntry (&CPU_STM32F10xInit); 


Ss /* 
板 级 初始 化 函数 到 内 核 */ 
TclSetBoardEntry (&EVB_ SetupBoard) 7 


S 省 
板 级 调试 打印 函数 到 内 核 */ 
吕 TclSetTraceRoutine (&EVB_Uart1WriteString) 7 





人 
用 户 初 始 化 函数 到 内 核 */ 
TclSetUserEntry (&APP LEDENtry); 


/* 
35 TclStartKernel (); 
136. 

1 return 1; 

i138 

139, 

140. 

141. #endif 





程序 运行 后 ，LED 的 变化 如 图 6-18 所 示 。 
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6-18 ”LED 的 变化 情况 














6.3.4 ”线程 间 的 双向 同步 数据 传输 


在 本 例 中 ， 我 们 通过 两 个 线程 的 同步 配合 ， 实 现 两 个 LED 分 别 按照 1 秒 的 间隔 点 亮 和 熄 炎 。 这 里 使 




















了 两 个 邮箱 。 


LED 线 程 0 首先 以 阻塞 方式 从 邮箱 0 读 取 邮件 ， 然 后 根据 邮件 内 容 点 亮 或 者 关闭 LED0;， 随 后 延 时 1 秒 ; 最 后 再 以 阻塞 方式 向 邮箱 1 中 发 送 邮件 。 


LED 线 程 1 首先 以 阻塞 方式 从 邮箱 1 读 取 邮件 ， 然 后 根据 邮件 内 容 点 亮 或 者 关闭 LED0; 最 后 以 阻塞 方式 向 邮箱 0 中 发 送 邮件 。 


在 这 个 例 程 里 ， 两 个 LED 线 程 的 同步 是 双向 向 的 ， 即 LED 线 程 1 的 运行 依赖 LED 线 程 2; LED 线 程 2 的 执行 也 依赖 于 LED 线 程 1， 因 


代码 清单 6-12: 邮箱 应 用 例 程 4 








为 它们 的 运行 都 依赖 于 某 个 邮箱 的 操作 。 程 序 实现 如 代码 清单 6-12 所 示 。 





下 #include 


“example.h 
” 


光 #include 


"trochilin 


” 


. js 
户 线程 参数 */ 


static 


MRWD 


: /* 
线程 栈 定义 */ 


所 Static 


酒 忆 中 FRR 酒 PRRR 酒 PPeoo 酒 muomew 














6 
i static TWord ThreadLED2Stack[THREAD LED STACK SIZE]; 
8. 
9, i 
月 户 邮 件 类 型 定义 */ 
20. typedef struct 
21. : 
22。 TIndex Index; 
23。 TByte Valuve; 
24. } TLEDMail; 
5 
26. 
Zs static TMailBox LEDIMailBox; 
2 static TMailBox LED2MailBox; 
这 3。 static TLEDMail LEDIMail; 
30. static TLEDMail LED2Mail; 
31. 
32. 
33; /* LED1 
线程 的 主 函数 */ 
34 static void ThreadLED1Entry (void* pArg) 
35。 { 
305 TErrno errno7 
37 . TLEDMail* pMaill; 
38 . TLEDMail* pMail2; 
39。 
40 . PMail2 = &LED2Mail7 
41. while (eTrue) 
42 . 证 
43 . /* LED1 
线程 以 阻塞 方式 接收 LED1 
控制 邮件 */ 
44. TclReceiveMail (&LEDIMailBox, (TMail*) (gpMaill1), IPC OPT WAIT, 0, &errno); 
45. 
46. /* LED1 
线程 控制 LED1 
的 点 亮 或 炸 灭 */ 
EVB_LEDControl (pMaill->Index, pMaill->Value); 

49. /* LED1 
线程 延 时 1 
秒 */ 
So TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 
31 
SR: /* LED1 

以 阻塞 方式 发 送 LED2 


点 亮 邮件 */ 
53 
54. 
55. 
56. 
57 


#if (EVB EXAMPLE 一 CH6 MAILBOX EXAMPLE4) 


#define THREAD LED STACK SIZE (512) 


#define THREAD LED PRIORITY (5) 
5 #qefine THREAD LED SLICE (20) 
0. 
LL 
户 线程 定义 */ 

static TThread ThreadLED]1; 


TThread ThreadLED2; 


TWord ThreadLED1Stack[THREAD LED STACK SIZE]; 


PMail2->Index = LED2; 
PMail2->Value = LED ON; 
TclSendMail (&LED2MailBox, (TMail*) (gpMail2), IPC OPT WAIT, 0, &errno); 


/* LED1 


线程 以 阻塞 方式 接收 LED1 


控制 邮件 */ 
58 . 





63 


/* TIED1 
线程 延 时 1 
秒 */ 
64. TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 
65; 
66. /* LED1 
线程 以 阻塞 方式 发 送 LED2 
熄灭 邮件 */ 
67. PMail2->Index = LED2; 
68. pMail2->Value = LED OFF; 
69. TclSendMail (gLED2MaJlBox, (TMail*) (&pMail2), IPC OPT WAIT, 0, &errno); 
70. b 
时 } 
72。 
了 73。 /* LED2 
线程 的 主 函数 */ 
74 static void ThreadLED2Entry (void* pArg) 
了 8， { 
了 TErrno errno7 
77 . TLEDMail* pMaill; 
78 . TLEDMail* pMail2; 
29, 
80. PMaill = &LED1Mail7 
81. while (eTrue) 
82. { 
83. /* LED2 
线程 以 阻塞 方式 发 送 LED1 
点 亮 邮件 */ 
84. PMaill->Index = LED17 
85 . PMaill->Value = LED ON; 
86. TclSendMail (gLEDIMailBox, (TMail*) (gpMail1), IPC OPT WAIT, 0, &errno); 
87. 
88. /* LED2 
线程 以 阻塞 方式 接收 LED2 
控制 邮件 */ 
89. TclReceiveMail (&LED2MailBox, (TMail*) (gpMail2), IPC OPT WAIT, 0, &errno); 
90 . 
91, /* LED2 


TclReceiveMail (&LEDIMailBox, (TMail*) (gpMaill1), IPC OPT WAIT, 0, &errno); 


/* LED1 


EVB_ LEDControl (pMaill->Index, pMaill->Value); 


EVB_LEDControl (pMail2->Index, pMail2->Value); 





94. /* LED2 
线程 以 阻塞 方式 发 送 LED1 
熄灭 邮件 */ 


95。 PMaill->Index = LED]1; 

96. pMaill->Value = LED OFF; 

97. TclSendMail (gLEDIMailBox, (TMail*) (&pMaill), IPC OPT WAIT, 0, &errno); 
98 . 

99, /* LED2 

线程 以 阻塞 方式 接收 LED2 

控制 邮件 */ 

100 . TclReceiveMail (&LED2MailBox, (TMail*) (gpMail2), IPC OPT WAIT, 0, &errno); 
101; 

102 . /* LED1 

线程 控制 LED1 

的 点 亮 或 熄灭 */ 

103, EVB_ LEDContro] (pMail2->Index, pMail2->Value); 

104. } 

i105 } 

106. 

OT /2 


用 户 应 用 入 口 函 数 */ 
108. static void APP LEDEntry (void) 








109。 { 

t10. TErrno errno; 

Tl 

112. 和 

配置 使 能 评估 板 上 的 LED 

设备 */ 

ls EVB LEDConfig(); 

114. 四 

115. 

初始 化 LED 

邮箱 */ 

116. TclInitMailBox (&LED2MailBox, IPC PROP NONE, &errno); 
TI17。 TclInitMailBox (&LEDIMailBox, IPC PROP NONE, &errno) 
118. 

119。 jm 

初始 化 LED1 

设备 控制 线程 */ 

120, TclInitThread(&ThreadLED]1, &ThreadLEDlEnNntry, (void*)NULL, 
121% ThreadLED1Stack，THREAD LED STACK SIZE, 
122. THREAD LED PRIORITY, THREAD LED SLICE); 
123， 

124. 人 

初始 化 LED2 

设备 控制 线程 */ 

125., TclInitThread (&ThreadLED2, &ThreadLED2EnNtry, (void*)NULL, 
126, ThreadLED2Stack, THREAD LED STACK SIZE, 
127。 THREAD LED PRIORITY + 1, THREAD LED SLICE); 
128. 

129. A 

激活 LED 

设备 控制 线程 */ 

0 TclActivateThread (&ThreadLED]1); 

131, TclActivateThread (&ThreadLED2); 

T1326 } 

133 

134. 

135, /» 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

136. int main (void) 

bac TE | 

138. A 

注册 处 理 器 初始 化 函数 到 内 核 */ 

139. TclSetCpuEntry (&CPU_STM32F10xInit); 

140. 

141. 

注册 板 级 初始 化 函数 到 内 核 */ 

142. TclSetBoardEntry (&EVB_SetupBoard); 

143. 

144. js 

注册 板 级 调试 打印 函数 到 内 核 */ 

5 TclSetTraceRoutine (&EVB UartlWritestring); 

146. 

147. Pd 

注册 用 户 初始 化 函数 到 内 核 */ 

148 . TclSetUserEntry (&APP LEDENtry); 

149. 

i150 

启动 内 核 */ 

151， TclStartKernel () 7 

152. 

L939 return 1; 

154. } 

155, 

156. #endif 








程序 运行 后 ，LED 的 变化 如 图 6-19 所 示 。 
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6-19 LED 的 变化 情况 














6.3.5 ”多 线程 同步 与 邮箱 刷新 




















在 本 例 中 ， 实 现 多 个 LED 线 程 和 1 个 控制 线程 的 单 向 同步 (没有 数据 传输 ) 。 实 现 三 个 LED 分 别 按照 1 秒 的 间隔 点 亮 和 熄灭 。 这 里 使 用 了 1 个 邮箱 。 
塞 方式 从 同一 邮箱 读 取 邮 件 ， 目 的 是 阻塞 在 邮箱 的 线程 阻塞 队列 上 ， 使 得 多 个 线程 的 执行 路 径 交 汇 在 一 起 。 而 控制 线程 则 是 每 隔 1 秒 对 邮箱 进行 一 次 刷 
解除 阻塞 。 代 码 实现 如 代码 清单 6-13 所 示 。 


代码 清单 6-13: 邮箱 应 用 例 程 5 


体 实现 时 ， 多 个 LED 线 程 的 线程 函数 相似 ， 都 是 以 阻 





新 操作 ， 使 得 那些 阻塞 在 邮箱 线程 阻塞 队列 上 的 线程 都 





1. #include 


“example.h 
加 


2. #include 
“trochili.h 

所 

3。 

4. #if (EVB EXAMPLE == CH6 MAILBOX EXAMPLE5) 
5 


6. /x 
用 户 线程 参数 */ 
7. #define THREAD LED STACK SIZE (256) 


8. #define THREAD LED PRIORITY (5) 
9. #define THREAD LED SLICE (20) 
10. 


11. #define THREAD CTRL STACK SIZE (256) 
12. #define THREAD CTRL PRIORITY (6) 
13. #define THREAD CTRL SLICE (20) 


1S。 /< 

用 户 线 程 定义 */ 

16. static TThread ThreadLED17 
17. static TThread ThreadLED27 
18. static TThread ThreadLED3; 
19. static TThread ThreadCTRL; 
20. 

a 

用 户 线程 栈 定义 */ 

22. static TWord ThreadLED1Stack 
23. static TWord ThreadLED2Stack 
24. static TWord ThreadLED3Stack 
25. static TWord ThreadCTRLStack 
26. 


Ed 
用 户 邮件 类 型 定义 */ 
28. typedef struct 


THREAD LED STACK SIZE] 
THREAD LED STACK SIZE] 
THREAD LED STACK SIZE] 
THREAD CTRL STACK SIZE 


1 


29. { 

30 . TIndex Index; 
SL TByte Value; 
32. } TLEDMail; 

33. 

34. 


Ss 

用 户 邮箱 和 邮件 定义 */ 

36. static TMailBox LEDMailbox; 

37. static TLEDMail LEDMail; 

38. 

39. Xt LEDL 

线程 的 主 函数 */ 

40. static void ThreadLED1Entry (void* pArg) 


网 计 > 二 

42. TErrno errno; 
43. TState state; 
44. TLEDMail* pMail; 
45. 

46. while (eTrue) 
47. { 

48 . /* LED3 





线程 以 阻塞 方式 接收 LED3 
的 控制 邮件 */ 
49. state = TclReceiveMail (&LEDMailbox, (TMail*) (gpMail), 


30. IPC OPT WAIT, 0, &errno); 
51, if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 
S52 { 

53: EVB_LEDControl (LED1, LED ON); 

54. } 

S56 

56 /* LED3 


线程 以 阻塞 方式 接收 LED3 
的 控制 邮件 >/ 





Sr state = TclReceiveMail (&LEDMailbox, (TMail*) (gpMail), 
58。 IPC OPT WAIT, 0, &errno); 
S39: if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 
60. { 
61 . EVB_LEDControl (LED1，LED OFF); 
62 . } 
63. } 
64. 1} 
, /* LED2 
程 的 主 函 数 */ 


. static void ThreadLED2Entry (void* pArg) 
{ 

TErrno errno; 

TState state; 

TLEDMail* pMail; 


while (eTrue) 


76. /* LED3 

线程 以 阻塞 方式 接收 LED3 

的 控制 邮件 */ 

EE state = TclReceiveMail (&LEDMailbox, (TMail*) (gpMail), 
78. IPC OPT WAIT, 0, &errno); 
79. if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 
80. { 

81. EVB LEDControl (LED2, LED ON); 

82. } 这 

83. 

84. /* LED3 

线程 以 阻塞 方式 接收 LED3 

的 控制 邮件 */ 

5. state = TclReceiveMail (&LEDMailbox, (TMail*) (gpMail), 
86. IPC OPT WAIT, 0, &errno); 
87 if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 
88. { 

89 . EVB_LEDControl (LED2, LED _ OFF) 

90. } 

91 。 } 

各 ,|} 

93。 

94. 

95,. /* LED3 


线程 的 主 函数 */ 

96. static void ThreadLED3Entry (void* pArg) 
97, { 

98. TErrno errno; 





99s TState state; 

100. TLEDMail* pMail; 

101. 

102. while (eTrue) 

103., { 

104. /* LED3 

线程 以 阻塞 方式 接收 LED3 

的 控制 邮件 */ 

DS state = TclReceiveMail (&LEDMailbox, (TMail*) (gpMail), 
106. IPC OPT WAIT, 0, &errno); 
TOF, if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 
108. { 

109. EVB LEDControl (LED3, LED ON); 

110。 } 区 加 

TT1;s 

下。 /* LED3 

线程 以 阻塞 方式 接收 LED3 

的 控制 邮件 */ 

ER state = TclReceiveMail (&LEDMailbox, (TMail*) (gpMail), 
114. IPC OPT WAIT, 0, &errno); 
和 if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 
116. { 

BET EVB_LEDControl (LED3, LED OFF); 

118. } 

119, } 

120. } 

TL21s 

122. 

Es 

主 控 线程 的 主 函 数 */ 

124. static void ThreadCTRLENtry (void* pArg) 

125. { 

126. TErrno errno; 

127% 

128. LEDMail.Index = Ou; 

129. while (eTrue) 

30 { 


i 

控制 线程 延 时 1 
和 2 

3 TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 
133。 


134. 2 
控制 线程 刷新 邮箱 的 线程 阻塞 队列 */ 
5 TclFlushMailBox (&LEDMailbox, &errno); 

















x 


136, 

137. Le 

计数 变化 ， 供 调试 检查 使 用 */ 

339， LEDMail .Indext++; 

139s } 

140. } 

141. 

142. 

1 

用 户 应 用 程序 入 口 函数 */ 

144. static void APP LEDEnNtry (void) 
| 

146 . TErrno errno; 

147. 

148 . 

配置 使 能 评估 板 上 的 LED 

设备 */ 

149. EVB LEDConfig(); 
150, 23 
41451., jw 

初始 化 邮箱 */ 

TH TclInitMailBox (&LEDMailbox, IPC PROP NONE, &errno); 
53 
154. 1 

初始 化 LED1 

设备 控制 线程 */ 

TS TclInitThread(&ThreadLED]1, &ThreadLEDlEnNntry, (void*)NULL, 
L566 ThreadLED1lStack, THREAD LED STACK SIZE, 
dD THREAD LED PRIORITY, THREAD LED SLICE); 

十 58: 
159, A 

初始 化 LED2 

设备 控制 线程 */ 

160 . TclInitThread (&ThreadLED2, &ThreadLED2EnNtry, (void*)NULL, 
8 ThreadLED2Stack, THREAD LED STACK SIZE, 
162. THREAD LED PRIORITY, THREAD LED SLICE); 
4， 
164. Vie 

初始 化 LED3 

设备 控制 线程 */ 

165. TclInitThread (&ThreadLED3, &ThreadLED3EnNntry, (void*)NULL, 
166. ThreadLED3Stack, THREAD LED STACK SIZE, 
167. THREAD LED PRIORITY, THREAD LED SLICE); 
168. 
189, /* 

初始 化 CTRL 

线程 */ 

170. TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
Ll ThreadCTRLStack, THREAD CTRL STACK SIZE, 
HS THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
L733。 

174. 人 

激活 LED 

线程 */ 








TclActivateThread (&ThreadLED1); 
TclActivateThread (&ThreadLED2); 
TclActivateThread (&ThreadLED3); 


/* 
E 控 线程 */ 
TclActivateThread (&ThreadCTRL); 














184. /* 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

185. int main (void) 

TGs. 生 

1 Fy 

注册 处 理 器 初始 化 函数 到 内 核 */ 

188. TclSetCpuEntry (&CPU_STM32F10xInit); 
189. 

190. A 

注册 板 级 初始 化 函数 到 内 核 */ 

191. TclSetBoardEntry (&EVB_SetupBoard); 
Lg 

193, A 

注册 板 级 调试 打印 函数 到 内 核 */ 

194. TclSetTraceRoutine (&EVB UartlWriteString); 
195, 

196. Le 

注册 用 户 初始 化 函数 到 内 核 */ 

a TclSetUserEntry (&APP LEDENtry); 
198. 

199. /* 

启动 内 核 */ 

200; TclStartKernel (); 

201. 

202: return 1; 

203:. } 

204. 


205% 


206. #endif 








程序 运行 后 ，LED 的 变化 如 图 6-20 所 示 。 
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6-20 ”LED 的 变化 情况 








6.3.6 ”多 线程 同步 与 邮箱 广播 





在 本 例 中 ， 实 现 多 个 LED 线 程 和 1 个 控制 线程 的 单 向 数据 传输 。 实 现 3 个 LED 分 别 按照 1 秒 的 间隔 点 亮 和 熄灭 。 这 里 使 用 了 1 个 邮箱 。 





具体 实现 时 ， 多 个 LED 线 程 的 线程 函数 相似 ， 都 是 以 阻塞 方式 从 同一 邮箱 读 取 邮 件 ， 


























一 次 广播 操作 ， 使 得 那些 阻塞 在 邮箱 线程 阻塞 队列 上 的 线程 都 解除 阻塞 。 而 被 解除 阻塞 的 线程 则 根据 邮件 的 内 容 点 亮 或 者 熄灭 LED。 代 码 实现 如 代码 清单 6-14 所 示 。 


代码 清单 6-14: 邮箱 应 用 例 程 6 


本 
“exampl 
” 

ss 
“trochi 
” 


3 
4. 
5. 
6. 
以 用 病程 


5 
用 户 线程 
了 区， 
2 
用 户 线程 
二 
Ys 
用 户 邮件 
2 


34. 
用 户 邮 箱 
35. 


39. 
的 线程 的 
40. 


e. 


#include 
h 


#inclugde 


4. 


#if (EVB EXAMPLE == CH6 MAILBOX EXAMPLF.6) 


/* 

参数 */ 
#define 
#define 
#define 


#define 


#define 
#define 


/* 
定义 */ 


THREAD LED STACK SIZE (256) 
THREAD LED PRIORITY (5) 
THREAD LED_SLICE (20) 
THREAD CTRI, STACK SIZE (256) 


THREAD CTRI, PRIORITY (6) 
THREAD CTRI, SLICE (20) 


static TThread ThreadLED17 
static TThread ThreadLED2; 
static TThread ThreadLED3; 
static TThread ThreadcTRL; 


人 
栈 定义 */ 


static TWord ThreadLED1Stack 
static TWord ThreadLED2Stack 
static TWord ThreadLED3Stack 
static TWord ThreadCTRLStack 


THREAD LED STACK SIZE]; 
THREAD LED STACK SIZE]; 
THREAD LED STACK SIZE]; 
THREAD CTRL STACK SIZE] 


/* 
类 型 定义 */ 


typedef 
{ 


struct 


TIndex Index; 
TByte Value; 
} TLEDMail; 


/* 

和 邮件 定义 */ 

static TMailBox LEDMailbox; 
static TLEDMail LEDMail; 


/* LED1 
主 函数 */ 


static void ThreadLEDlEntry (void* pArg) 


{ 


TErrno errno; 
TState state; 
TLEDMail* pMail; 


while (eTrue) 


{ 


48. /* LED3 
线程 以 阻塞 方式 接收 邮件 ， 并 根据 邮件 内 容 控制 LED3 


的 点 亮 或 
49 


50. 
51. 


者 熄灭 */ 





state = TclReceiveMail (&LEDMailbox, (TMail*) (&pMail)， 
IPC OPT WAIT, 0, &errno); 
if (state == eSuccess) 


的 是 阻塞 在 邮箱 的 线程 阻塞 队列 上 ， 使 得 多 个 线程 的 执行 路 径 交 汇 在 一 起 。 而 控制 线程 则 是 每 隔 1 秒 则 对 邮箱 进行 














S52 { 

D3 EVB_LEDControl (LED1, pMail->Value); 
54. F 

Ss } 

56. } 

537; 

58. /* LED2 

的 线程 的 主 函数 */ 

ba static void ThreadLED2Entry (void* pArg) 

60 . { 

61. TErrno errno; 

62. TState state; 

63 . TLEDMail* pMail; 

64. 

65> while (eTrue) 

66. 4 

67. /* LED3 

线程 以 阻塞 方式 接收 邮件 ， 并 根据 邮件 内 容 控制 LED3 

的 点 亮 或 者 烛 灭 */ 

68 state = TclReceiveMail (&LEDMailbox, (TMail*) (gpMail), 
69. IPC OPT WAIT, 0, &errno); 
70. if (state 一 eSuccess) 

71. { 

了 EVB_LEDControl (LED2, pMail->Value); 
3 条 

74. } 

9. a 

了 

了。 /* LED3 

线程 的 主 函数 */ 

J static void ThreadLED3Entry (void* pArg) 

了 35 { 

80. TErrno errno; 

el; TState state; 

82. TLEDMail* pMail; 

3 

84. while (eTrue) 

85. 


86. /* LED3 

线程 以 阻塞 方式 接收 邮件 ， 并 根据 邮件 内 容 控制 LED3 
的 点 亮 或 者 烽 灭 */ 
87. 








state = TclReceiveMail (&LEDMailbox, (TMail*) (&pMail)， 














88. IPC OPT WAIT, 0, &errno); 
9 if (state == eSuccess) > 

90. 

91. EVB_LEDControl (LED3, pMail->Value); 
2. 3 

93; 让 

94 . } 

5 

96. 

87 

主 控 线程 的 主 函 数 */ 

983 static void ThreadCTRLENtry (void* pArg) 

号 { 

100. TErrno errno; 

101. TLEDMail* pMail = &LEDMail; 

102. while (eTrue) 

1035 { 

104 类 








空 制 线程 延 时 1 
秒 */ 
08 TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 
106. 
107. ep 
控制 线程 广播 所 有 LED 
开 的 邮件 */ 

108 . PMail->Index = LEDALL ;，; 

109. PMail->Value = LED ON; 

110. TclBroadcastMail (&LEDMailbox, (TMail*) (&pMail), &errno); 
TL 
112. A 
控制 线程 延 时 1 

秒 */ 
六 TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 
114. 
115. 2 

空 制 线程 广播 所 有 LED 

熄灭 的 邮件 */ 

LEG pMail->Index = LEDALL 

L171» PMail->Value = LED OFF; 

村 全 TclBroadcastMail (&LEDMailbox， (TMail*) (gpMail), &errno); 
T1193 } 

TB 和 

121. 

122, 

Ei dn 

用 户 应 用 入 口 函 数 */ 

124. static void APP LEDEntry (void) 














125% 帮 

E26, TErrno errno; 

L233 

了 

配置 使 能 评估 板 上 的 LED 

设备 */ 

129. EVB_LEDConfig () 7 

二 3 

hs 

初始 化 邮箱 */ 

EE 罗江 TclInitMailBox (&LEDMailbox, IPC PROP NONE, &errno); 
8 

134. i 

初始 化 LED1 

设备 控制 线程 */ 

139., TclInitThread (&ThreadLED1， &ThreadLED1Pntry， (void*)NULL, 
136 ThreadLED1lStack, THREAD LED STACK SIZE, 
Ey THREAD LED PRIORITY, THREAD LED SLICE); 
LI 

Ya 

初始 化 LED2 

设备 控制 线程 */ 

140 . TclInitThread (&ThreadLED2, &ThreadLED2EnNntry, (void*)NULL, 
141. ThreadLED2Stack, THREAD LED STACK SIZE, 
142. THREAD LED PRIORITY, THREAD LED SLICE); 
143% 

144. 

初始 化 LED3 

设备 控制 线程 */ 

145. TclInitThread (&ThreadLED3, &ThreadLED3EnNntry, (void*)NULL, 
146. ThreadLED3Stack, THREAD LED STACK SIZE, 
147. THREAD LED PRIORITY, THREAD LED SLICE); 
148. 

149 . A 

初始 化 CTRL 

线程 */ 

150. TclInitThread (&ThreadCTRL， &ThreadCTRLENtry, (void*)NULL, 
151. ThreadCTRLStack, THREAD CTRL STACK SIZE, 
5 THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
53 

154. A 

激活 LED 

线程 */ 

te TclActivateThread (&ThreadLPD1) 7 

156 . TclActivateThread (&ThreadLPD2) 7 

LS TclActivateThread (&ThreadLED3); 

158. 

09. 2 


激活 主 控 线程 */ 
160. TclActivateThread (&ThreadCTRL); 





下 5 





162 . 

163. 

164. /* 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

165. int main (void) 

166. { 

167. 

注册 处 理 器 初始 化 函数 到 内 核 */ 

168 . TclSetCpuEntry (&CPU_STM32F10xInit) 7 
169 . 

17Q。 

注册 板 级 初始 化 函数 到 内 核 */ 

L771s TclSetBoardEntry (&EVB_SetupBoard); 
72 

L173 ey 

注册 板 级 调试 打印 函数 到 内 核 */ 

174. TclSetTraceRoutine (&EVB UartlWriteString); 
175% 

176. Re 

注册 用 户 初始 化 函数 到 内 核 */ 

LPs TclSetUserEntry (&APP LEDENtry); 
178; 

179。 A 

启动 内 核 */ 

180. TclStartKernel (); 

181. 

182 . return 1; 

183. } 

184. 

185. 

186. #endif 








程序 运行 后 ，LED 的 变化 如 图 6-21 所 示 。 
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6-21 LED 的 变化 情况 








6.3.7 ”强制 解除 线程 阻塞 


在 本 例 中 ， 邮 件 被 定义 为 LED 的 控制 命令 。 两 个 线程 通过 邮箱 发 送 和 接收 邮件 ， 从 而 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 





其 中 LED 线 程 则 不 停 地 以 阻塞 方式 尝试 接收 邮件 ， 然 后 根据 接收 结果 进行 LED 的 控制 : 如 果 是 线程 LED 被 解除 阻塞 则 点 亮 LED; 然后 再 次 尝试 接收 邮件 ， 如 果 是 邮箱 再 次 被 解除 阻塞 则 熄灭 LED; 主 控 线 
程 不 停 地 按照 1 秒 的 间隔 取消 初始 化 邮箱 ， 初 始 化 邮箱 ， 循 环 往复 。 程 序 实现 如 代码 清单 6-15 所 示 。 


代码 清单 6-15: 邮箱 应 用 例 程 7 





Ls #include 
“example.h 
六 


蔚 。 #include 
“trochili.h 


3， 

4. #if (EVB EXAMPLE == CH6 MAILBOX _ EXAMPLE7) 
5. 

6. /* LED 

设备 参数 * 

了 #define LED ON (1) 

是 #define LED OFF (0) 

9. #define LED INDEX (1) 

10. 


TI。 es 
用 户 线程 参数 */ 
12 #define THREAD LED STACK SIZE (256) 


13; #define THREAD LED PRIORITY {5) 
14. #define THREAD LED SLICE (20) 
15. 

EB #define THREAD CTRL STACK SIZE (256) 
Le #define THREAD CTRL PRIORITY (4) 
1 #define THREAD CTRL SLICE (20) 
9s 


20. J 

用 户 线程 定义 */ 

起。 static TThread ThreadLED; 
22。 static TThread ThreadcTRL; 


24. 


用 户 线 程 栈 定义 */ 

















2 static TWord ThreadLEDStack [THREAD LED STACK SIZE]; 
26. static TWord ThreadCTRLStack[THREAD CTRL STACK SIZE]; 
人 

28 . 交 

用 户 邮件 类 型 定义 */ 

29, typedef struct 

30. 

Ss TIndex Index; 

32 . TByte Value 

和 } TLEDMail; 

34. 

5, 

用 户 邮箱 定义 */ 

3 static TMailBox LEDMailbox; 

3 

38 . 

39s /* LED 

线程 的 主 函数 */ 

40. static void ThreadLEDEnNtry (void* pArg) 

41. { 

42. TErrno errno; 

43. TState state; 

44. TLEDMail* pMail; 

45. 

46. while (eTrue) 

47. 

48 . /* LED 

线程 以 阻塞 方式 接收 邮件 */ 

49. state = TclReceiveMail (gLEDMailbox, (TMail*) (gpMail), IPC OPT WAIT, 0, &errno); 
50. if ((state != eSuccess) && (errno & ERR IPC ABORT)) 
Sls { 

B23 EVB_LEDControl (LED INDEX, LED ON); 

53. } 

54. 

S55, /* LED 

线程 以 阻塞 方式 接收 邮件 */ 

56. state = TclReceiveMail (&LEDMailbox， (TMail*) (gpMail), IPC OPT WAIT, 0, &errno); 
Bl if ((state != eSuccess) && (errno & ERR IPC ABORT)) Sa 
58: 

59, EVB_LEDConNntrol (LED INDEX, LED OFF); 

60. } 

61. } 

62 . 

63. 

64. /* 

主 控 线程 的 主 函 数 */ 

G5; static void ThreadCTRLENtry (void* pArg) 

66. { 

BT TErrno errno; 

68. 

69. while (eTrue) 

0s 

71 六 








主 控 线 程 延 时 1 
秒 */ 
J TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 
74. A 

线程 解除 LED 

昌 在 邮箱 上 的 阻塞 */ 

5 TclAbortMailBox (&LEDMailbox, &ThreadLED, &errno); 
76. } 

77. } 

78. 

79. 


80. a 

用 户 应 用 入 口 函 数 */ 

81. static void APP LEDEntry (void) 
82 . { 

3 TErrno errno; 


/* 
配置 人 LED 


#5 EVB_LEDConfig () 7 








87. 了 
初始 化 邮箱 */ 
88 . TclInitMailBox (&LEDMailbox, IPC PROP NONE, &errno) 7 


SO。 1 

初始 化 LED 

设备 控制 线程 */ 

91 . TclInitThread (&ThreadLED，&ThreadLEDEntry， (void*)NULL, 
92; ThreadLEDStack, THREAD LED STACK SIZE, 
93 THREAD LED PRIORITY, THREAD LED SLICE); 


95. /* 





TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
ThreadcTRLStack, THREAD CTRL STACK SIZE, 
THREAD CTRL PRIORITY, THREAD CTRL SLICE); 


TclActivateThread (&ThreadLED); 


. 
E 控 线程 */ 
TclActivateThread (&ThreadCTRL); 











/* 
器 BOOT 
之 后 会 调用 main 
函数 ， 必 须 提供 */ 
109. int main (void) 
TI0. 1 
开业 A 
注册 处 理 器 初始 化 函数 到 内 核 */ 
Em TclSetCpuEntry (&CPU_STM32F10xInit); 
EE 
114. A 
注册 板 级 初始 化 函数 到 内 核 */ 
TD TclSetBoardEntry (&EVB_SetupBoard); 
Rk 
eh > 
注册 板 级 调试 打印 函数 到 内 核 */ 
Tl TclSetTraceRoutine (&EVB UartlWriteString); 
了 1 
120% A 
注册 用 户 初始 化 函数 到 内 核 */ 
Tl TclSetUserEntry (&APP LEDENtry); 
工区 区 
3 
启动 内 核 */ 
124. TclStartKernel (); 
1 
126. return 1; 
村 
Teg 
129. #endif 








程序 运行 后 ，LED 的 变化 如 图 6-22 所 示 。 
















1 
1 
1 
1 
L 
1 
1 
1 
1 
1 
1 
1 
1 
十 
1 
1 
1 
1 
-TT---- 
1 
1 
1 
nls 
1 
1 
1 
1 
. 
1 
1 
1 
1 
十 
1 
1 
1 
1 
T 
1 
1 
1 
1 
1 
1 
1 
1 


一 一 一 一 | 一 一 一 一 -Il 一 一 -一 -一 一 一 一 + 一 一 一 上 一 一 一 一 HH 一 一 一 -一 上 +- 一---H- 一 一 一 一 一 一- 


ON ' OFF ' ON ,OFF ' ON ' OFF' ON OFF ' ON IOFF ON 


ET 


1 

1 

1 1 1 1 1 1 1 1 1 

1 1 1 1 1 1 1 1 1 
有 
1 1 1 1 1 1 1 1 1 

1 1 






时 间 
To WM 人 13 "4 3 "le 工 1 9 0 


6-22 LED 的 变化 情况 














6.3.8 ”邮箱 取消 初始 化 


在 本 例 中 ， 邮 件 被 定义 为 LED 的 控制 命令 。 两 个 线程 通过 邮箱 发 送 和 接收 邮件 ， 从 而 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 





其 中 LED 线 程 不 停 地 以 阻塞 方式 尝试 接收 邮件 ， 然 后 根据 接收 结果 进行 LED 的 控制 : 如 果 是 线程 LED 被 取消 初始 化 则 点 亮 LED， 然 后 再 次 尝试 接收 邮件 ; 如 果 是 邮箱 再 次 被 取消 初始 化 则 熄灭 LIED。 主 控 
线程 不 停 地 按照 1 秒 的 间隔 取消 初始 化 邮箱 ， 初 始 化 邮箱 ， 循 环 往复 。 注 意 在 这 个 例 程 中 ，LED 线 程 和 主 控 线程 都 没有 数据 传输 。 程 序 实现 如 代码 清单 6-16 所 示 。 








代码 清单 6-16: 邮箱 应 用 例 程 8 





1 #include 

“example.h 

六 

之 。 #include 

“trochili.h 

六 

3 

4. #if (EVB EXAMPLE 一 CH6 MAILBOX FXAMPLE8) 


6. /x 
用 户 线程 参数 */ 
I #define THREAD LED STACK SIZE (256) 


时 #define THREAD LED PRIORITY (5) 
9. #define THREAD LED SLICE (20) 
10; 

11。 #define THREAD CTRL STACK SIZE (256) 
12, #define THREAD CTRL PRIORITY (4) 
13; #define THREAD CTRL SLICE (20) 
14. 


15. 
用 户 线程 栈 定义 */ 
Tb static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 


7 static TWord ThreadCTRLStack[THREAD CTRL STACK SIZE]; 
18. 

二 gs J 

用 户 线程 定义 */ 

六 中; static TThread ThreadLED; 

这 static TThread ThreadCTRIL;7 

22: 

23. by 

用 户 邮件 类 型 定义 */ 

24. typedef struct 

25: 

6 TIndex Index; 

27. TByte Value; 

28 . } TLEDMail; 

29, 

30. 

用 户 邮箱 定义 */ 

SLs static TMailBox LEDMailbox; 

32. 

33. 

34. /* LED 

线程 的 主 函数 */ 

5s static void ThreadLEDENtry (void* pArg) 

36. { 

Ss TErrno errno; 

38 TState state; 

EE TLEDMail* pMail; 

40. 

41. while (eTrue) 

42. { 

43. /* LED 

线程 以 阻塞 方式 接收 邮件 */ 

44. state = TclReceiveMail (&LEDMailbox, (TMail*) (gpMail), 
45. IPC OPT WAIT, 0, &errno); 
46. if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 
47. 

48 . EVB_LEDControl (LED1, LED ON); 

49. } 

50 . 

SL: /* LED 

线程 以 阻塞 方式 接收 邮件 */ 

S52: state = TclReceiveMail (&LEDMailbox, (TMail*) (gpMail), 
53 IPC OPT WAIT, 0, &errno); 
54. if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 
55 { 

56. EVB_LEDControl (LED1, LED OFF); 

57. } 

58 . } 

39 } 

60. 


61. We 
主 控 线 程 的 主 函 数 */ 


3 static void ThreadCTRLEnNtry (void* pArg) 


63. { 

64. TErrno errno; 
65. while (eTrue) 
66. { 

67 过 








主 控 线程 延 时 1 

秒 */ 

68. TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 
69. 


70. 

主 控 线 程 重 置 邮箱 ， 然 后 再 次 初始 化 邮箱 */ 

这 到 5 TclDeinitMailBox (&LEDMailbox, &errno); 

本 TclInitMailBox (&LEDMailbox, IPC PROP NONE, &errno) 7 
13、 } 

74. } 

3 

7176. 

77. i 

用 户 应 用 入 口 函 数 */ 

78 . static void APP LEDENtry (void) 

19. { 

80. TErrno errno; 

81. 
82. we 

配置 使 能 评估 板 上 的 LED 

设备 */ 

83. EVB_LEDConfig(); 
84. 
85. En 
初始 化 邮箱 */ 
86. 








TclInitMailBox (&LEDMailbox, IPC PROP NONE, &errno); 
87. 
88. 人 

初始 化 LED 

设备 控制 线程 */ 

89. TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
90. ThreadLEDStack, THREAD LED STACK SIZE, 
91. THREAD LED PRIORITY, THREAD LED SLICE); 
92. 
93 

初始 化 CTRL 

线程 */ 

94. TclInitThread (&ThreadCTRL， &ThreadCTRLENtry, (void*)NULL, 
95 . ThreadCTRLStack，THREAD CTRL STACK SIZE, 
96. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
97 . 


98 . 
激活 LED 
线程 */ 
ds TclActivateThread (&ThreadLED); 
100. 

101. [gs 

激活 主 控 线程 */ 

102. TclActivateThread (&ThreadCTRL); 
103. } 

104. 

L105 

106. 

107。/ 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 
108. int main (void) 
109。 1 

110. es 

注册 处 理 器 初始 化 函数 到 内 核 */ 

111 TclSetCpuEntry (&CPU_STM32F10xInit); 
于 125 
113。 Ww 

注册 板 级 初始 化 函数 到 内 核 */ 

114. TclSetBoardEntry (&EVB_SetupBoard); 
115 
116. SA 

注册 板 级 调试 打印 函数 到 内 核 */ 

这 后 TclSetTraceRoutine (&EVB UartlWriteSstring); 
118. 
119。 

注册 用 户 初始 化 函数 到 内 核 */ 

120 . TclSetUserEntry (&APP LEDENtry); 
121; 

122。 a 

启动 内 核 */ 

123, TclStartKernel (); 

124. 

125. return 1; 

126. } 

i127 

128. #endif 





/* 


























程序 运行 后 ，LED 的 变化 如 图 6-23 所 示 。 
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6-23 LED 的 变化 情况 














第 7 章 ”消息 队列 设计 与 实现 


和 邮箱 类 似 ， 消 息 队列 也 是 内 核 提 供 的 用 于 任务 间 、 任 务 和 ISR 间 数据 传输 的 功能 模块 ， 不 同 的 是 消息 队列 拥有 一 个 消息 缓冲 区 可 以 用 来 保存 更 多 的 消息 。 本 章 将 详细 介绍 消息 队列 机 制 的 原理 以 及 设计 
实现 ， 并 用 实际 代码 演示 消息 队列 的 典型 使 用 。 


7.1 消息 队列 基础 








本 节 我 们 将 介绍 消息 队列 的 概念 、 功 能 和 使 用 模型 。 








7.1.1 ”消息 队列 的 概念 












































消息 队列 是 用 于 任务 间 进 行 数据 交换 的 一 种 内 核 机 制 。 通 过 这 种 机 制 ， 内 核 完成 任务 间 和 任务 /ISR 间 的 数据 传输 。 在 具体 实现 上 ， 消 息 队列 拥有 一 个 数据 缓冲 区 ， 可 以 保存 一 定数 量 的 数据 ， 具 有 消息 
缓存 的 功能 。 内 核 是 通过 消息 队列 结构 来 管理 消息 队列 的 ， 消 息 队列 的 结构 如 图 7-1 所 示 。 
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图 7-1 消息 队列 结构 




















消息 队列 结构 主要 包括 一 个 容量 大 小 足够 的 消息 数据 区 、 任 务 阻塞 队列 ， 另 外 还 有 记录 消息 区 信息 的 其 他 成 员 ， 比 如 消息 区 的 消息 计数 、 头 尾 指针 等 ， 这 个 和 内 核 的 具体 实现 有 关 。 

















消息 队列 能 够 容纳 的 最 多 的 消息 数目 称 为 消息 队列 的 长 度 ， 或 者 称 为 消息 队列 的 容量 ， 需 要 在 消息 队列 初始 化 的 时 候 和 消息 数据 区 地 址 一 起 给 出 。 在 消息 队列 中 ， 保 留 第 一 条 消息 的 队列 元 素 称 为 队列 
头 ， 保 存 最 后 一 条 消息 的 队列 元 素 称 为 队 尾 。 



































消息 长 度 指 的 是 消息 数据 区 中 ， 每 个 消息 自身 的 长 度 ， 这 与 消息 的 结构 有 关 。 结 构 化 的 消息 可 以 携带 很 多 信息 给 应 用 程序 。 但 也 可 以 把 消息 定义 为 一 个 指针 ， 然 后 通过 这 个 指针 指向 具体 的 消息 数据 。 
体 采 用 哪 种 方式 和 内 核 的 实现 相关 。 
































消息 队列 中 定义 了 任务 阻塞 队列 ， 那 些 发 送 和 接收 消息 的 任务 ， 当 操作 不 成 功 时 ， 有 时 需要 阻塞 在 消息 队列 的 任务 阻塞 队列 上 。 


1. 消息 队列 状态 











消息 队列 通常 拥有 3 种 状态 : 空 、 普 通 、 满 。 当 消息 状态 刚刚 建立 的 时 候 ， 它 处 于 空 的 状态 。 当 有 消息 发 送 进来 时 ， 它 处 于 普通 状态 。 当 消息 队列 中 的 消息 数目 达到 消息 队列 长 度 时 ， 它 就 处 于 满 状 态 。 
随 着 消息 的 写 入 和 读 出 ， 消 息 队列 的 状态 在 这 3 种 情况 下 相互 转换 ， 符 合 有 限 状 态 机 机 制 。 图 7-2 描 述 了 消息 队列 的 状态 迁移 和 原因 。 


























发 送 消息 
消息 数目 增加 1， 
但 是 没有 达到 最 大 


发 送 1 个 消息 ， 
使 得 消息 数目 达到 
发 送 1 个 消息 队列 长 度 


初始 化 消 消息 数目 
息 数 目 等 普通 达到 消息 
0 队列 长 度 


接收 1 个 消息 接收 1 个 消息 
使 得 消息 数 
目 为 0 
接收 消息 
es 目 减少 
， 但 是 不 等 于 0 





图 7-2 ”消息 队列 状态 迁移 











当 消 息 队列 处 于 空 的 状态 时 ， 如 果 有 任务 来 读 取消 息 ， 那 么 它 会 直接 返回 失败 ， 或 者 阻塞 到 该 消息 队列 上 ， 直 到 有 可 读 的 消息 或 者 到 达 阻 塞 时 限 ; 当 消 息 队列 处 于 满 状 态 时 ， 如 果 有 任务 来 发 送 ， 那 么 











同样 ， 它 会 直接 返回 失败 ， 或 者 阻塞 到 该 消息 队列 上 。 注 意 |SR 操 作 消息 队列 时 ， 只 能 立刻 返回 操作 结果 ， 这 是 因为 |SR 不 能 被 阻塞 。 














.消息 通信 


消息 在 任务 间或 者 任务 和 ISR 间 传递 时 ， 出 于 性 能 考虑 ， 有 以 下 两 种 方式 : 


“ 一 种 方式 是 把 任务 发 送 过 来 的 消息 完全 从 该 任务 的 空间 复制 到 消息 队列 空间 。 然 后 当 接收 任务 来 接收 数据 时 ， 再 将 数据 从 消息 队列 空间 复制 到 接收 任务 的 空间 。 


另 一 种 方式 是 在 消息 内 保存 数据 的 指针 ， 而 不 是 消息 本 身 。 需 要 接收 数据 的 任务 处 理 数据 的 复制 和 内 存 的 管理 。 














第 一 种 方式 的 缺点 是 效率 低 ， 需 要 复制 两 次 完整 的 数据 ， 这 两 次 复制 发 生 在 发 送 者 把 数据 发 送 到 消息 队列 和 接收 者 从 消息 队列 读 取 数 据 的 时 候 ， 如 图 7-3 所 示 。 


发 送 消息 的 任务 消息 队列 接收 消息 的 任务 


消息 指针 | 
数组 
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图 7-3 消息 复制 传递 过 程 








第 二 种 方式 在 对 内 存 的 使 用 和 性 能 上 是 比较 有 利 的 。 和 第 一 种 方式 相 比 ， 消 息 两 次 完整 的 复制 被 简化 成 两 次 指针 变量 赋值 操作 ， 如 图 7-4 所 示 。 











发 送 消息 的 任务 消息 队列 接收 消息 的 任务 
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图 7-4 消息 指针 传递 过 程 





需要 注意 的 是 ， 当 消息 队列 为 空 时 ， 如 果 有 任务 处 于 消息 队列 的 任务 阻塞 队列 中 ， 说 明 消息 队列 的 任务 阻塞 队列 是 消息 读 取 队列 。 如 果 此 时 有 任务 向 消息 队列 中 发 送 消息 ， 可 以 直接 从 消息 队列 的 等 待 
队列 中 找到 一 个 合适 的 任务 ， 并 立刻 使 得 它 读 取 消息 成 功 ， 同 时 消息 队列 的 状态 不 变 。 在 这 种 情况 下 ， 消 息 传递 过 程 中 只 发 生 一 次 消息 (或 指针 ) 复制 。 类 似 地 ， 在 消息 队列 可 以 读 取 时 ， 如 果 有 任务 处 于 
消息 队列 的 任务 阻塞 队列 ， 则 说 明 当 前 消息 队列 的 等 待 队列 是 消息 发 送 队列 ， 假 如 此 时 有 任务 来 读 取消 息 ， 可 以 先 从 消息 队列 中 读 取消 息 ， 然 后 再 从 消息 队列 的 任务 阻塞 队列 中 找到 一 个 合适 的 任务 ， 使 得 
它 的 消息 发 送 成 功 。 此 时 消息 队列 状态 同样 保持 不 变 。 








7.1.2 ”消息 队列 的 操作 











常见 的 消息 队列 的 应 用 如 表 7-1 所 示 。 





功能 操作 操作 功能 
1 消息 队列 创建 Broadcast ”| 向 消息 队列 广播 消息 
消息 队列 删除 消息 队列 任务 阻塞 队列 的 刷新 
3 从 消息 队列 中 接收 消息 消息 队列 查询 


4 向 消息 队列 发 送 消息 


(1) Create 消 息 队 列 创建 











创建 消息 队列 时 ， 用 户 需 要 指定 消息 队列 中 消息 区 地 址 和 消息 的 最 大 数目 ， 即 消息 的 容量 ， 同 时 还 可 以 指定 消息 队列 的 各 种 参数 属性 。 比 如 针对 多 个 任务 在 消息 队列 上 的 阻塞 和 调度 方式 : 既 可 以 按照 
FIFO 方 式 来 处 理 ， 也 可 以 按照 任务 优先 级 来 处 理 。 


(2) Delete 消 息 队 列 删除 
删除 消息 队列 时 ， 需 要 把 所 有 阻塞 在 消息 队列 上 的 任务 解除 阻塞 ， 并 且 清 空 消息 缓冲 区 ， 如 果 是 动态 分 配 的 资源 还 需要 释放 它 所 占 的 存储 空间 。 消 息 队列 一 旦 被 删除 ， 就 不 能 再 次 操作 了 。 
(3) Receive 接 收 消息 


如 果 消 息 队 列 为 空 ， 则 当前 任务 会 直接 返回 ， 或 者 阻塞 在 消息 队列 的 任务 阻塞 队列 中 ; 如 果 消息 队列 非 空 非 满 ， 则 直接 将 消息 从 消息 队列 中 读 出 ; 如 果 消 息 队 列 状态 为 满 ， 则 任务 首先 从 消息 队列 中 取 
得 消息 ， 然 后 进一步 检查 消息 队列 的 任务 阻塞 队列 中 是 否 有 因为 消息 队列 满 而 无 法 成 功 发 送 消息 的 任务 。 如 果 有 则 会 把 那个 被 阻塞 任务 需要 发 送 的 消息 放 入 消息 队列 ， 随 后 唉 醒 该 任务 程 ; 如 果 此 时 没有 任 
务 被 阻塞 ， 则 当前 任务 直接 返回 。 


(4) Send 发 送 消息 


如 果 消 息 队列 状态 为 满 ， 则 当前 任务 或 者 直接 返回 ， 或 者 被 阻塞 在 消息 队列 的 任务 阻塞 队列 中 ; 如 果 消 息 队列 状态 非 空 非 满 ， 则 直接 将 消息 保存 到 消息 队列 里 ; 如果 消息 队列 为 空 ， 那么 任务 会 检查 是 
否 有 任务 因 无 法 获得 消息 而 被 阻塞 ， 如 果 有 则 会 把 消息 直接 发 给 那个 被 阻塞 的 任务 ， 随 后 当前 任务 返回 ; 如 果 此 时 没有 任务 被 阻塞 ， 则 当前 任务 直接 发 送 消 息 到 消息 队列 并 返回 。 


(5) Broadcast 发 送 广播 消息 

当 有 多 个 任务 因为 不 能 接收 到 消息 而 阻塞 在 消息 队列 时 ， 可 以 通过 广播 方式 向 这 些 任务 发 送 相同 的 消息 ， 完 成 多 任务 的 同步 和 通信 。 得 到 相同 消息 的 任务 需要 谨慎 处 理 广播 消息 。 
(6) Flush 清 空 任务 阻塞 队列 

当 有 多 个 任务 因为 不 能 接收 或 者 发 送 消 息 而 阻塞 在 消息 队列 时 ， 可 以 通过 Flush 操 作 将 这 些 任务 解除 阻塞 ， 完 成 多 任务 的 同步 。 

(7) Query 消 息 队 列 查询 


应 用 程序 可 以 随时 查看 某 个 消息 队列 的 当前 状态 ， 将 信号 量 的 数据 结构 复制 后 分 析 。 但 需要 注意 因为 复制 出 来 的 数据 只 是 系统 菜 个 时 刻 的 情况 ， 所 以 需要 用 户 苦 酌 使 用 。 


7.1.3 ”消息 队列 的 典型 应 用 




















消息 队列 在 实际 使 用 中 ， 有 它 自己 特殊 的 模式 ， 下 面 介绍 几 个 常见 的 消息 队列 的 使 用 模型 。 


























1. 单 向 异步 消息 传输 











在 这 种 模式 下 ， 一 个 任务 用 来 从 消息 队列 接收 消息 ， 另 外 一 个 任务 或 者 1ISR 向 消息 队列 中 发 送 消息 。 发 送 过 程 和 接收 过 程 没有 过 多 联系 ， 发 送 任务 或 1SR 不 必 了 解 接收 任务 的 情况 。 如 图 7-5 所 示 。 


消息 队列 

















发 送 消息 的 任务 


接收 消息 的 任务 


消息 指针 





图 7-5 单 向 异步 消息 传递 


在 这 种 模式 下 ， 系 统 的 行为 和 两 个 任务 的 优先 级 是 密切 相关 的 (ISR 的 优先 级 必然 高 于 任务 的 优先 级 ) 。 首 先 我 们 假设 两 个 任务 分 别 不 停 地 发 送 和 接收 消息 。 





“ 假如 发 送 任务 的 优先 级 高 于 接收 任务 的 优先 级 ， 并 且 发 送 任务 首先 执行 。 发 送 任务 会 一 直 发 送 消息 到 消息 队列 中 ， 直 到 消息 队列 被 填 满 ， 发 送 任务 才 会 停止 发 送 并 阻塞 在 消息 队列 的 任务 阻塞 队列 
上 。 之 后 接收 任务 才 得 以 运行 ， 取 得 第 一 个 消息 ， 而 这 个 操作 导致 内 核 立刻 唤醒 发 送 任务 ， 同 时 把 待 发 送 的 消息 保存 到 消息 队列 中 ， 只 有 消息 队列 状态 仍然 为 满 。 随 后 发 送 任务 再 次 发 送 消息 ， 发 送 任务 会 
再 次 阻塞 。 随 后 接收 任务 再 次 运行 ， 再 次 接收 第 二 个 消息 ， 此 后 消息 队列 永远 是 满 的 ， 消 息 依次 被 楼 收 任务 处 理 。 除 非 发 送 任务 不 再 发 送 新 的 消息 这 个 过 程 才 会 停止 。 

“ 假如 发 送 任务 的 优先 级 低 于 接收 任务 的 优先 级 ， 并 且 接 收 任务 首先 执行 。 因 为 消息 队列 开始 时 为 空 ， 所 以 接收 任务 立刻 阻塞 在 消息 队列 的 任务 阻塞 队列 上 ， 随 后 发 送 任务 得 到 处 理 器 。 因 为 此 时 消息 


队列 为 空 并 且 接收 任务 阻塞 在 消息 队列 上 ， 所 以 消息 不 必 发 送 到 消息 队列 中 ， 而 是 可 以 直接 发 送 给 接收 任务 。 因 为 优先 级 抢占 ， 接 收 任务 立刻 执行 ， 处 理 消息 后 ， 因 为 消息 队列 又 变 成 空 的 ， 所 以 接收 任务 
会 再 次 阻塞 。 而 此 后 发 送 任务 则 再 次 运行 ， 再 次 直接 发 送 一 个 消息 给 接收 任务 ， 接 收 任务 也 再 次 被 唤醒 。 在 这 个 过 程 中， 消息 队 列 一 直 是 空 的 。 


























ISR 通 常 使 用 第 1 种 方式 ， 因 为 ISR 是 要 抢占 任何 任务 来 执行 的 。 另 外 ，ISR 必 须 使 用 非 阻塞 方式 来 发 送 消息 ， 如 果 发 送 操作 不 能 成 功 则 消息 会 丢失 。 这 种 模式 的 伪 代 码 如 代码 清单 7-1 所 示 。 























代码 清单 7-1: 消息 队列 单 向 异步 传输 


35. void TaskSender (void) 


36 . 

Ss http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/t 
38 Send message to MessageQueue; 

39; http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/t 
40. 1} 

41. 

42. void TaskReceiver (void) 

汪汪 

44. http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/t 
45. Receive message from MessageQueue; 

46. http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/t 
47. 1} 





2. 单 向 同步 消息 传输 





有 时 候 ， 发 送 任务 发 送 消息 后 ， 希 望 得 到 接收 消息 的 确认 ， 也 就 是 说 ， 发 送 过 程 和 接收 过 程 有 同步 的 约定 。 如 此 一 来 ， 系 统 的 可 靠 性 就 更 高 了 。 同 步 过 程 可 以 通过 前 面 介绍 的 二 值 信号 量 来 实现 ， 如 图 
7-6 所 示 。 








-> 下 渤 息 队列 下 





接收 消息 的 任务 


图 7-6 单 向 同步 消息 传输 


在 图 


:如果 发 送 任务 的 优先 级 高 ， 则 发 送 消息 的 任务 首先 运行 ， 可 以 一 次 发 送 1 个 消息 到 消息 队列 中 ， 然 后 获取 信号 量 ， 因 为 信号 


量 
务 开始 执行 ， 接 收 任务 首先 从 消息 队列 中 读 取 1 个 消息 ， 然 后 释放 信号 量 ， 确 认 消 息 已 经 被 正确 接收 。 随 后 发 送 任务 收 到 信和 号 量 ， 再 次 发 送 新 的 消息 。 





7-6 所 示 的 模型 中 ， 包 括 一 个 二 值 信号 量 、 一 个 消息 队列 和 两 个 任务 。 初 始 时 ， 信 号 量 为 0， 消 息 队列 为 空 。 每 次 消息 传递 都 有 1 次 信号 量 的 同步 ， 两 个 任务 都 是 按照 发 送 -接收 -确认 的 流程 来 执行 


初始 时 为 0， 所 以 发 送 任务 阻塞 在 信号 量 的 任务 阻塞 队列 上 。 随 后 接收 任 


“ 如 果 接 收 任务 的 优先 级 高 ， 则 接收 任务 首先 运行 。 因 为 消息 队列 开始 时 为 室 ， 所 以 接收 任务 阻塞 在 消息 队列 上 。 随 后 发 送 任务 开始 执行 ， 发 送 消息 后 ， 接 收 任务 立刻 抢占 执行 ， 接 收 到 消息 后 ， 会 释 


放 信号 


这 种 模式 的 伪 代 码 如 代码 清单 7-2 所 示 。 


代码 清单 7-2: 消息 队列 单 向 同步 传输 


量 ， 然 后 再 次 去 接收 消息 ， 它 会 再 次 阻塞 。 发 送 任务 执行 后 ， 获 取信 号 量 ， 然 后 再 次 发 送 消息 。 注 意 ISR 不 能 阻塞 ， 所 以 不 适合 这 个 消息 队列 的 这 个 模式 。 





=-} 


. Void TaskSender (void) 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 


Send message to MessageQueue; 
Obtain binary semaphore 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 


. Void TaskReceiver (void) 


1{ 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/.. 


Receive message from MessageQueue; 
Release binary semaphore 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/.. 


.http://www.hzcourse.com/resource/readBook?path=/openresources/ 


.http://www.hzcourse.com/resource/readBook?path=/openresources/ 


http://www.hzcourse.com/resource/readBook?path=/openresources/ 


http://www.hzcourse.com/resource/readBook?path=/openresources/ 





3. 双向 同步 消息 传输 


任务 间 
机 制 ， 如 图 


如 图 





的 消息 传递 有 时 是 双向 的 ， 如 经 典 的 客户 机 -服务 器 模型 。 客 户 机 向 服务 器 发 送 请 求 ， 然 后 服务 器 向 客户 机 发 送 响应 。 在 很 多 嵌入 式 系统 中 都 采 


7-7 所 示 。 


消 息 愉 Wl 


图 7-7 双向 同步 消息 传输 























清单 7-3 所 示 。 


代码 清单 7-3: 消息 队列 用 于 双向 同步 











了 基于 消息 队列 的 方式 来 实现 任务 间 的 消息 传递 








7-7 所 示 ， 有 两 个 消息 队列 用 于 这 种 双向 同步 的 模型 。 通 常 把 服务 器 任务 的 优先 级 设置 得 高 于 客户 机 服务 器 任务 的 优先 级 ， 这 样 利于 服务 器 任务 尽快 处 理 客户 机 任务 的 请 求 。 该 模型 的 伪 代 码 如 代码 











1. void TaskClient (void) 
2. 1{ 
3 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPSVText/. .http://www.hzcourse.com/resource/readBook?path=/openresources/t 
4. Send REQUEST message to Server 
Ss Receive RESPONSE message from Server 
和 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/t 
si 
8. 
9. void TaskServer (void) 
10.{ 
Th http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/t 
1 Receive REQUEST message from client 
3 Send RESPONSE message to client 
14. http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPSVText/. .http://www.hzcourse.cor/resource/readBook?path=/openresources/t 
下 和 
4. 消息 广播 通信 





广播 消息 可 以 给 所 有 在 消息 队列 的 任务 阻塞 队列 上 的 任务 发 送 相同 的 消息 。 是 一 对 多 的 关系 ， 如 图 7-8 所 示 。 


任务 或 者 ISR 消息 队列 
消息 指针 | 
数组 








图 7-8 消息 广播 














如 图 7-8 所 示 ， 有 多 个 任务 都 在 等 待 读 消息 队列 ， 当 有 任务 向 消息 队列 广播 消息 时 ， 所 有 阻塞 在 消息 队列 上 的 任务 都 会 同时 被 解除 阻塞 ， 并 得 到 一 个 相同 的 消息 。 这 是 一 种 多 任务 同步 的 模型 。 这 里 需要 




















注意 的 是 ， 因 为 多 个 任务 得 到 的 是 相同 的 消息 ， 那 么 如 果 这 个 消息 是 动态 分 配 的 ， 如 何 处 理 又 是 个 值得 考虑 的 事情 。 消 息 广 播 的 伪 代 码 如 代码 清单 7-4 所 示 。 





代码 清单 7-4: 消息 队列 用 于 广播 同步 





37. void TaskReceiver (void) 


38 

39. http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse. 
40. Receive message from MessageQueue; 

41. http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse. 
42. 1} 

43. 

44. void TaskBroadcast (void) 

45. 

46. http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse. 
47. Broadcast message to MessageQueue; 

48 . http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/..http://www.hzcourse. 
49. 1} 


com/resource/readBook?path=/openresources/ 


com/resource/readBook?path=/openresources/ 


com/resource/readBook?path=/openresources/ 


com/resource/readBook?path=/openresources/ 





7.2 ”消息 队列 功能 设计 























从 本 节 开 始 我 们 介绍 Trochili RTOS 的 消息 队列 的 具体 设计 、 实 现 和 应 用 。 消 息 队列 结构 定义 在 文件 message.h 中 ， 其 定义 如 代码 清和 








代码 清单 7-5: 消息 队列 结构 定义 


7-5 所 示 。 





让 
消息 队列 结构 定义 */ 





2. struct MessageQueueCB 
3 { 
4. TProperty Property; Li 
消息 队列 属性 配置 Wf 
Es TWord MsgEntries; VV 
消息 队列 中 消息 的 数目 */ 
6. void** MsgPool; 
消息 缓冲 池 */ 
ss TWord Capacity; J 
消息 队列 容量 要 

TIndexTail; Ei 
消息 队列 读 指 针 位 置 A 
9。 TIndex Head; 
消息 队列 写 指针 位 置 wf 
10, TMOStatus Status; 
消息 队列 状态 yy 
Tt。 TIpcQueue Queue; 的 
消息 队列 的 线程 阻塞 队列 */ 
2 


13.typedef struct MessageQueueCB TMsgQueue; 





“ Property 消 息 队 列 属性 集合 : 包括 消息 队列 是 否 被 初始 化 、 线 程 阻塞 队列 的 调度 策略 等 。 
"MsgEntries 消 息 计数 : 记录 了 当前 在 消息 队列 缓存 池 中 有 多 少 消息 。 

:Capacity 消 息 队 列 容量 : 消息 队列 的 消息 池 的 长 度 ， 说 明了 消息 队列 最 多 能 容纳 多 少 条 消息 。 
:Tail 消 息 尾 部 游标 : 记录 了 在 消息 队列 中 ， 等 待 被 读 取 的 消息 在 消息 池 (数组 ) 中 的 位 置 。 


Head 消息 头 部 游标 : 记录 了 在 消息 队列 中 ， 可 以 存放 普通 消息 的 位 置 ( 紧 急 消息 存放 在 Tail 游 标的 前 一 个 位 置 ) 





Status 邮箱 状态 : 消息 队列 有 三 种 状态 ， 即 满 、 空 、 非 空 非 满 。 在 下 面 将 有 专门 的 分 析 。 


:Queue 线 程 阻塞 队列 : 前 面 介绍 过 该 类 型 的 队列 有 两 个 分 队列 ， 因 为 消息 队列 支持 不 同类 型 的 消息 ， 所 以 会 同时 使 用 该 队列 中 的 两 个 分 队列 。 其 中 每 个 分 队列 都 可 以 按照 需要 配置 成 不 同调 度 策略 ， 并 


且 紧 急 消息 一 定 优先 普通 消息 处 理 。 














相 比 邮箱 ， 这 个 结构 变化 很 大 ， 这 也 是 为 什么 消息 队列 和 邮箱 的 实现 ， 没 有 像 二 值 信号 量 和 计数 信号 量 那样 放 在 一 起 实现 的 原因 。 两 者 最 大 的 不 同 在 于 消息 队列 维护 管理 着 一 个 消息 池 ， 消 息 池 的 位 











和 大 小 由 用 户 设 定 。 











省 


消息 队列 结构 如 图 7-9 所 示 。 








当 有 线程 阻塞 在 消息 队列 的 线程 阻塞 队列 时 ， 消 息 队列 各 成 员 间 的 关系 如 图 7-10 所 示 。 
















message length 


------------------------- 和 


queue length 





图 7-9 消息 队列 结构 


~ 
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-一 一 ~ 





图 7-10 消息 队列 和 线程 阻塞 


Trochili RTOS 支 持 的 消息 队列 的 功能 主要 有 以 下 几 种 。 
“ 消息 队列 初始 化 (Init) : 初始 化 一 个 已 存在 的 消息 队列 结构 ， 不 管 这 个 结构 是 由 内 存 动态 分 配 而 来 还 是 一 个 全 局 变量 。 消 息 队列 初始 化 之 后 才 可 以 进行 其 他 操作 。 当 前 版 本 不 支持 消息 队列 的 动态 创 


建 和 删除 。 
消息 队列 取消 初始 化 (Peinit) : 清空 消息 队列 的 线程 阻塞 队列 ， 所 有 被 阻塞 的 线程 都 得 到 操作 失败 的 返回 值 。 清 空 消息 队列 中 的 消息 。 消 息 队 列 返 回 初始 化 前 的 最 初 状态 。 


发 送 消息 (Send) : 线程 或 者 ISR 将 指定 的 消息 发 送 到 消息 队列 。 消 息 的 类 型 可 以 是 普通 消息 或 者 紧急 消息 。 有 可 能 造成 发 送 消息 的 线程 阻塞 在 消息 队列 的 线程 阻塞 队列 中 。 

接收 消息 (Receive) : 线程 或 者 ISR 从 消息 队列 中 接收 消息 。 有 可 能 造成 接收 消息 的 线程 阻塞 在 消息 队列 的 线程 阻塞 队列 中 。 从 使 用 习惯 上 来 说 ， 不 建议 用 户 在 ISR 中 调用 这 个 函数 。 
广播 消息 (Broadcast) : 向 消息 队列 的 线程 阻塞 队列 中 的 线程 群发 消息 ， 每 个 线程 都 得 到 消息 并 且 得 到 成 功 的 返回 值 。 但 多 个 线程 共享 的 是 同一 个 消息 ， 即 同一 个 地 址 。 

取消 线程 阻塞 (Abort) : 将 指定 的 线程 从 消息 队列 的 线程 阻塞 队列 中 解除 阻塞 ， 使 得 它 不 再 等 待 消息 的 收发 事件 。 可 以 将 无 限 阻塞 的 线程 或 者 时 限 等 待 的 线程 提前 解除 阻塞 。 


: 清空 线程 阻塞 队列 (Flush) : 将 消息 队列 线程 阻塞 队列 中 的 所 有 线程 都 解除 阻塞 。 


对 消息 队列 功能 的 总 结 见 表 7-2。 
表 7-2 消息 队列 功能 


一 一 本 ET 
ET 对 
Wi 2 


ET 
请 加 

一 asaeseeue | nan 
AN 





7.2.1 消息 队列 初始 化 


调用 消息 队列 初始 化 函数 比较 简单 ， 这 里 不 做 流程 分 析 。 该 函数 的 主要 步骤 如 下 : 
: 设置 消息 队列 属性 为 就 绪 

: 清空 消息 队列 消息 池 

“ 设置 消息 队列 状态 为 空 


“ 初始 化 消息 队列 线程 阻塞 队列 


7.2.2 ”消息 队列 取消 初始 化 


消息 队列 取消 初始 化 和 消息 队列 初始 化 是 相反 的 操作 。 它 会 对 消息 队列 做 如 下 操作 : 


“ 重新 设置 消息 队列 为 非 初始 化 状态 





: 清空 消息 队列 的 线程 阻塞 队列 


“ 清空 消息 队列 内 的 消息 


“ 设置 消息 队列 状态 为 空 


“ 如 果 有 必要 还 会 进行 线程 调度 





消息 队列 取消 初始 化 流程 图 如 图 7-11 所 示 。 











1 开始 





4 重 置 消息 队列 状态 为 空 ; 








10 返回 


图 7-11 消息 队列 取消 初始 化 流程 图 





流程 图 分 析 : 











STEP2 内核 进入 临界 区 。 

STEP3 首先 将 消息 队列 的 线程 阻塞 队列 清空 ， 唤 醒 全 部 被 阻塞 的 线程 。 

STEP4 取消 初始 化 消息 队列 状态 ; 清空 消息 池 ; 取消 消息 队列 的 就 绪 属 性 。 

STEP5 检查 在 清空 消息 队列 的 线程 阻塞 队列 时 是 否 唤醒 了 比 当前 线程 优先 级 更 高 的 线程 。 

STEP6 如 果 是 ， 则 检查 该 函数 是 否 被 线程 调用 。 

STEP7 如 果 是 ， 则 检查 内 核 是 否 允 许 线程 调度 。 

STEP8 如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 

STEP9 内 核 退 出 独占 区 ， 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP10 ”函数 返回 。 


7.2.3 ”消息 接收 


从 消息 队列 中 接收 消息 的 操作 主要 是 由 以 下 几 个 函数 来 完成 的 。 





“ 消息 接收 接口 函数 xMQReceive () : 该 函数 是 消息 队列 模块 向 外 提供 的 接口 函数 ， 被 内 核 API 函 数 调用 。 它 根据 操作 模式 这 个 参数 来 区 分 处 理 本 次 消息 的 接收 操作 。 根 据 操 作 模式 的 不 同 ， 操 作 可 以 
分 为 线程 模式 和 ISR 模 式 ， 还 可 以 进一步 细 分 为 线程 阻塞 方式 (无 限期 和 时 限 ) 、 线 程 立刻 返回 和 ISR 立 刻 返回 3 种 模式 。 


: 另外 由 该 函数 完成 和 消息 队列 相关 的 内 核 数据 的 保护 工作 。 


“ 线程 接收 消息 函数 ReceiveMessage () : 该 函数 实现 了 线程 接收 消息 的 核心 远 辑 。 它 首先 会 通过 函数 TryReceiveMessage () 尝试 从 消息 队列 中 读 取消 息 ， 然 后 根据 结果 来 继续 操作 。 后 继 操 作 包 括 成 功 
后 的 线程 调度 检查 和 失败 后 的 线程 阻塞 操作 都 是 在 这 里 完成 的 。 


"ISR 接收 消息 函数 IstrReceiveMessage () : 该 函数 比较 简单 ， 在 用 户 ISR 里 不 需要 考虑 线程 调度 的 问题 ， 这 个 问题 是 由 内 核 解 决 的 。 它 同 线程 接收 消息 函数 一 样 ， 同 样 是 调用 函数 


TryReceiveMessage () 。 
“ 尝试 接收 消息 函数 TryReceiveMessage) : 这 个 函数 是 接收 消息 的 核心 部 分 ， 它 会 根据 消息 队列 状态 来 处 理 本 次 请 求 。 
“ 如 果 消 息 队 列 状态 为 空 ， 则 直接 返回 失败 。 


“ 如 果 消 息 队 列 状态 为 满 ， 则 首先 读 消息 ， 然 后 检查 在 该 消息 队列 的 线程 阻塞 队列 中 是 否 有 线程 存在 。 如 果 此 时 不 存在 被 阻塞 的 线程 ， 则 线程 收取 消息 后 直接 返回 ; 如 果 存 在 ， 则 说 明 这 些 被 阻塞 的 
线程 ， 都 是 因为 消息 队列 满 而 不 能 发 送 消息 的 线程 ， 所 以 本 次 消息 操作 不 会 对 消息 队列 状态 有 任何 影响 ， 只 需要 在 全 部 阻塞 线程 中 找到 一 个 合适 的 线程 并 解除 阻塞 ， 再 把 该 线程 发 送 的 消息 保存 到 消息 队列 


“ 如 果 此 时 消息 队列 不 满 也 不 空 ， 则 直接 从 消息 队列 中 接收 一 个 消息 。 
:在 上 面 几 个 步骤 中 ， 如 果 需 要 都 会 重新 设置 消息 队列 的 状态 。 


“ 消息 处 理 函 数 ConsumeMessage () : 这 个 函数 是 消息 队列 内 具体 消息 的 操作 函数 ， 它 会 把 消息 从 消息 队列 中 取出 并 且 调整 消息 队列 的 消息 头 尾 指针 的 位 置 。 























这 几 个 函数 的 层次 关系 比较 简单 。 注 意 xMessageReceive () 起 到 的 是 分 发 调用 的 作用 ， 函 数 ReceivvMessage () 和 lsrReceiveMessage () 是 不 同 运 行 环境 下 的 具体 操作 函数 ， 而 
TryReceiveMessage () 的 主要 作用 是 操作 消息 队列 对 象 。 这 几 个 函数 的 流程 图 如 图 7-12 至 图 7-14 所 示 。 




































































1. 消息 接收 接口 函数 





消息 接收 接口 函数 的 流程 图 如 图 7-12 所 示 。 

















4ISR 读 消 息 5 线程 谈 消 息 


6 内 核 退 出 独占 区 











7-12 ”接收 消息 接口 函数 流程 图 











流程 图 分 析 : 











STEP2 内核 进入 独占 区 。 

STEP3 判断 是 不 是 ISR 来 读 取消 息 。 
STEP4 如 果 是 ， 则 调用 ISR 读 消息 函数 。 
STEP5 ”如果 不 是 ， 则 调用 线程 读 消息 函数 。 
STEP6 ”内核 退出 独占 区 。 


STEP7 函数 返回 。 





从 图 7-12 中 可 以 看 出 ， 这 个 函数 只 是 个 接口 函数 ， 只 是 根据 操作 类 型 判断 下 一 步 该 怎么 执行 。 














2. 线程 接收 消息 函数 





线程 接收 消息 函数 的 流程 图 如 图 7-13 所 示 。 

















流程 图 分 析 : 


STEP2 ”当前 线程 尝试 接收 消息 。 


STEP3 判断 本 次 接收 消息 操作 是 否 成 功 ， 如 果 是 ， 则 转 到 STEP11。 


STEP4 如 果 没 有 成 功 ， 则 需要 检查 本 次 操作 是 不 是 阻塞 模式 。 
STEP5 判断 内 核 是 否 允 许 线程 调度 。 


STEP6 如 果 是 ， 则 此 时 需要 保存 本 次 操作 的 信息 到 线程 相关 结构 ， 并 将 当前 线程 阻塞 在 消息 队列 的 线程 阻塞 队列 。 









8 内 核 退出 独占 区 


线程 争 壮 阶 盘 


v 
9 内 核 进入 独占 区 


二 本 


图 7-13 ”线程 接收 消息 函数 流程 图 


盏 





STEP7 向 内 核发 出 线程 调度 请 求 。 


STEP8 内 核 退 出 独占 区 ， 因 为 是 在 线程 环境 下 ， 退 出 后 极 有 可 能 发 生 线程 调度 ， 除 非 此 时 有 ISR 及 时 发 生 并 且 发 送 了 消息 给 当前 线程 ; 如 果 发 生 了 调度 则 当前 线程 被 阻塞 ， 直 到 被 解除 阻塞 。 
STEP9 ”线程 被 唤醒 并 且 调 度 执 行 ， 在 这 里 立刻 使 得 内 核 进入 独占 区 。 

STEP10 读 取 本 次 接收 消息 操作 的 结果 ， 随 后 清空 当前 线程 的 IPC 缓 存 信息 

STEP11 如 果 在 STEP4 成 功 读 取消 息 ， 则 需要 检查 在 读 取消 息 时 是 否 唤醒 了 比 当前 线程 优先 级 更 高 的 线程 。 

STEP12 如 果 是 ， 则 需要 检查 内 核 此 时 是 否 允 许 线程 调度 。 

STEP13 如果 是 ， 则 向 内 核 申请 线程 调度 。 


STEP14 ”函数 返回 。 





从 上 面 的 流程 中 可 以 看 出 ， 在 线程 接收 消息 的 获取 时 ， 首 先 会 尝试 一 下 ， 在 尝试 的 过 程 中 可 能 成 功 也 可 能 失败 (在 成 功 时 ， 有 可 能 唤醒 了 阻塞 在 消息 队列 上 的 线程 ， 而 被 唤醒 的 这 个 线程 的 优先 级 可 能 
比 当前 线程 更 高 ) ， 然 后 再 根据 尝试 的 结果 进行 以 下 操作 : 失败 了 可 能 需要 把 自己 阻塞 ; 成 功 了 有 可 能 需要 进行 线程 调度 。 这 段 代码 的 核心 逻辑 就 在 这 里 。 该 函数 的 伪 代 码 如 代码 清单 7-6 所 示 。 








代码 清单 7-6: 线程 接收 消息 代码 演示 





了 > 
pd 息 


Sa 息 ol 读 取消 息 ; 
( 
oa 息 ) 


人 入 话 本 ) 
内 以 设 有 关闭 各 各 调度 ) ) 


市 请 线 各 调度; 

9. } 
10. } 

11。 else 

12。 { 

并 下 攻 《 
线程 以 阻塞 方式 来 接收 消息 ) 
并 且 ( 

内 核 没有 关闭 线程 调度 ) ) 
14. { 





线程 IPC 
凡 息 ; 


和 得 阻塞 在 该 消息 队列 的 阻塞 队列 ; 


ia 得 申请 调度 ; 
打开 系统 中 断 ; 
9 

20. 
此 时 此 处 非常 有 可 能 发 生 一 次 调度 ， 除 非 线 各 调度 请 求 被 内 核 取消 


和 时 ， 从 本 处 继续 运行 。 














尝试 接收 消息 函数 





出 


尝试 接收 消息 函数 的 流程 图 如 图 7-14 所 示 。 




















流程 图 分 析 : 








STEP2 检查 消息 队列 状态 是 否 为 如 果 是 ， 则 返回 失败 。 





图 7-14 ”尝试 接收 消息 函数 流程 图 


STEP3 检查 消息 队列 状态 是 否 为 满 ， 如 果 不 是 ， 则 转 到 STEP10。 

STEP4 如 果 是 ， 则 首先 从 消息 队列 中 读 取 一 个 消息 。 

STEP5 然后 尝试 从 信号 量 的 线程 阻塞 队列 中 唤醒 一 个 线程 。 

STEP6 检查 是 否 有 线程 被 唤醒 。 同 时 该 函数 会 检查 和 记录 被 唤醒 的 线程 的 优先 级 是 不 是 比 当前 线程 更 高 。 
STEP7 如 果 没 有 ， 则 需要 重新 设置 消息 队列 状态 。 

STEP8 如 果 有 ， 则 需要 检查 该 线程 发 送 的 是 什么 类 型 的 消息 。 

STEP9 将 该 消息 保存 到 消息 队列 中 。 

STEP10 从 消息 队列 中 读 取 一 个 消息 。 


STEP11 重新 设置 消息 队列 状态 。 





STEP12 函数 返回 。 


从 图 7-14 中 可 以 看 出 ， 在 尝试 读 取消 息 时 ， 并 不 区 分 该 函数 是 被 线程 调用 还 是 被 SR 调用。 这 个 函数 主要 是 操作 消息 队列 。 消 息 队列 为 空 时 是 不 能 读 取消 息 的 ， 而 消息 队列 为 满 时 有 可 能 存在 阻塞 的 线 
程 。 该 函数 的 伪 代 码 如 代码 清单 7-7 所 示 。 








代码 清单 7-7: 尝试 接收 消息 代码 演示 





下 

尝试 接收 消息 
2. 1{ 

:四 于 全 
消息 队列 状态 为 空 ) 
4. { 

3 
设置 返回 结果 失败 ; 
6. } 


else if ( 


Rs 
济 居 队列 凑 态 为 江 ) 
- 4 





9. 

从 消息 队列 中 读 取 一 个 消息 给 当前 线程 
尝试 唤醒 写 阻塞 队列 中 的 一 个 线程 ; 

1s if 

唤醒 了 某 个 线程 

12; { 

13。 

根据 线程 所 处 的 分 队列 判断 消息 类 型 
14 


将 该 线程 发 送 的 消息 写 入 消息 队列 
15. } 


1 else 

二 

18 . 

更 新 消息 队列 状态 

不 这 

20. 

设置 返回 结果 成 功 ; 

21. } 

22, else /* if (mgq->Status == eMQONormal) */ 
23。 { 

24. 

从 消息 队列 中 读 取 一 个 消息 给 当前 线程 ; 
5 

更 新 消息 队列 状态 ; 

26. 

设置 返回 结果 成 功 ; 

27. } 

28. 

返回 结 

29,} 





7.2.4 消息 发 送 


消息 的 发 送 操作 主要 是 由 以 下 几 个 函数 来 完成 的 。 





:发送 消息 接口 函数 xMQSendMessage () : 该 函数 是 消息 队列 模块 向 外 提供 的 接口 函数 ， 被 内 核 API 函 数 调用 。 它 根据 操作 模式 这 个 参数 来 区 分 处 理 本 次 消息 发 送 的 操作 。 根 据 操作 模式 的 不 同 ， 操 作 
可 以 分 为 线程 模式 和 ISR 模 式 ， 还 可 以 进一步 细 分 为 线程 阻塞 方式 〈 无 限期 和 时 限 ) 、 线 程 立刻 返回 和 ISR 立 刻 返 回 3 种 模式 。 另 外 由 该 函数 完成 和 消息 队列 相关 的 内 核 数据 的 保护 工作 。 


“ 线程 发 送 消息 函数 SendMessage () : 该 函数 实现 了 线程 发 送 消息 的 核心 逻辑 。 它 会 首先 通过 函数 TrySendMessage () 向 消息 队列 中 发 送 消 息 ， 然 后 根据 结果 来 继续 操作 。 后 继 操作 包括 成 功 后 的 线程 
调度 检查 和 失败 后 的 线程 阻塞 操作 都 是 在 这 里 完成 的 。 


:IJISR 发 送 消息 函数 IsrSendMessage () : 该 函数 比较 简单 。 因 为 在 ISR 里 不 会 有 线程 调度 。 它 同 线程 发 送 消息 函数 一 样 ， 同 样 是 调用 尝试 发 送 消息 函数 TrySendMessage () 。 
“ 尝试 发 送 消 息 函 数 TrySendMessage () : 这 个 函数 是 发 送 消息 的 核心 部 分 ， 它 会 根据 消息 队列 的 状态 来 处 理 本 次 请 求 。 
“ 如果 消息 队列 的 状态 为 满 ， 则 直接 返回 失败 。 


:如果 消息 队列 的 状态 为 空 ， 则 需要 检查 消息 队列 的 线程 阻塞 队列 是 否 有 线程 存在 。 如 果 有 ， 说 明 此 时 那些 被 阻塞 的 线程 ， 都 是 因为 消息 队列 为 空 而 不 能 接收 消息 的 线程 ， 所 以 本 次 发 送 消息 操作 不 
会 对 消息 队列 状态 有 任何 影响 。 只 需要 在 全 部 阻塞 线程 中 找到 一 个 合适 线程 唤醒 ， 并 使 得 它 的 消息 接收 成 功 即 可 ; 如 果 没 有 ， 则 需要 发 消息 到 消息 队列 中 。 


:如果 消息 队列 状态 不 满 也 不 空 ， 则 直接 将 消息 保存 到 消息 队列 中 。 
“ 在 上 面 几 步 中 ， 如 果 需 要 都 会 更 新 消息 队列 状态 。 


' 消息 保存 函数 SaveMessage () : 该 函数 用 作 把 消息 保存 到 消息 队列 中 ， 根 据 消息 类 型 的 不 同 ， 消 息 可 能 被 放 在 队列 尾 或 者 队列 头 。 























这 几 个 函数 的 层次 关系 比较 简单 。 注 意 xMQSendMessage () 起 到 的 是 分 发 调用 的 作用 ， 函 数 SendMessage () 和 TrySendMessage () 是 不 同 运行 环境 下 的 具体 操作 函数 ， 而 
TrySendMessage () 则 主要 是 操作 消息 队列 对 象 。 这 几 个 函数 的 流程 图 如 图 7-15 至 图 7-17 所 示 。 












































1. 发 送 消息 接口 函数 





发 送 消息 接口 函数 的 流程 图 如 图 7-15 所 示 。 














图 7-15 ”发送 消息 接口 函数 流程 图 


流程 图 分 析 : 


STEP2 


STEP3 


STEP4 


STEP5 


STEP6 


STEP7 


内 核 进入 独占 区 。 

判断 是 不 是 ISR 来 发 送 消息 。 

如 果 是 ， 则 调用 ISR 发 送 消息 函数 。 

如 果 不 是 ， 则 调用 线程 发 送 消息 函数 。 
内 核 退 出 独占 区 。 


函数 返回 。 


从 图 7-15 中 可 以 看 出 ， 这 个 函数 只 是 个 接口 函数 ， 只 是 根据 操作 类 型 判断 下 一 步 该 怎么 执行 。 





2. 线程 发 送 消息 函数 


线程 发 送 消息 函数 的 流程 图 如 图 7-16 所 示 。 














线程 阻塞 阶段 
YY 





图 7-16 ”线程 发 送 消息 函数 流程 图 
流程 图 分 析 : 
STEP2 ”当前 线程 尝试 发 送 消息 。 
STEP3 判断 本 次 发 送 消息 操作 是 否 成 功 ， 如 果 成 功 ， 则 转 到 STEP13。 
STEP4 如果 没有 成 功 ， 则 需要 检查 本 次 操作 是 不 是 阻塞 模式 。 
STEP5 如 果 是 ， 则 判断 内 核 是 否 允 许 线程 调度 。 
STEP6 ”如果 允许 ， 则 判断 是 否 发 送 的 是 紧急 消息 。 
STEP7 如 果 是 ， 则 在 线程 的 IPC 记 录 中 标明 紧急 消息 ， 将 要 使 用 消息 队列 的 辅助 线程 阻塞 队列 。 
STEP8 保存 本 次 操作 的 信息 到 线程 结构 ， 并 将 当前 线程 阻塞 在 消息 队列 的 线程 阻塞 队列 。 
STEP9 向 内 核发 出 线程 调度 请 求 。 


STEP10 内核 退出 独占 区 ， 因 为 是 在 线程 环境 下 ， 退 出 后 极 有 可 能 发 生 线 程 调度 ， 除 非 此 时 有 ISR 及 时 发 生 并 且 发 送 了 消息 给 当前 线程 ;如 果 发 生 了 调度 ， 则 当前 线程 被 阻塞 ， 直 到 被 解除 阻塞 。 


STEP11 ”线程 被 唤醒 并 且 调 度 执行 ， 在 这 里 立刻 进入 独占 区 。 


STEP12 读 取 本 次 发 送 消息 操作 的 结果 ， 随 后 清空 当前 线程 的 IPC 缓 存 信息 


STEP13 如果 在 STEP3 成 功 发 送 消息 ， 则 需要 检查 在 发 送 消息 时 是 否 唤 醒 了 比 当前 线程 优先 级 更 高 的 线程 。 


STEP14 ”如果 是 ， 则 需要 检查 内 核 此 时 是 否 允 许 线程 调度 。 


STEP15 ”如果 允许 ， 则 向 内 核发 出 线程 调度 请 求 。 


STEP16 函数 返回 。 





从 上 面 的 流程 中 可 以 看 出 ， 在 线程 发 送 消息 的 获取 时 ， 首 先是 尝试 一 下 ， 在 尝试 的 过 程 中 可 能 成 功 也 可 能 失败 (在 成 功 的 时 候 ， 有 可 能 唤醒 了 阻塞 在 消息 队列 上 的 线程 ， 而 被 唤醒 的 这 个 线程 的 优先 级 
可 能 比 当前 线程 更 高 ) ， 然 后 再 根据 尝试 的 结果 进行 以 下 操作 : 失败 了 可 能 需要 把 自己 阻塞 ; 成 功 了 有 可 能 需要 进行 线程 调度 。 该 函数 的 伪 代 码 如 代码 清单 7-8 所 示 : 




















代码 清单 7-8: 线程 发 送 消息 代码 演示 





二 
Fe 


3 

尝试 发 息 ; 
4. 让 
en) 





人 到) 
由 生生 人 全 全 调度 ) ) 


市 请 线程 调度 ， 
9. } 
10 } 
TL else 
了 { 

3 


13. if (( 

和 
( 

Wed 


如 朱 是 紧急 消 息 则 在 线程 IPC 
al 





LTs : 

当前 线程 阻塞 在 该 消息 队列 的 阻塞 队列 ， 
18. 

当前 线程 申请 调度 ; 

19. 

2 


地 过 有 可能 发 生 一 次 调度 ， 除 非 线程 调度 请 求 被 内 核 取消 ; 
和 时 ， 从 本 处 继续 运行 。 


了 和; 
获得 对 消 | 息 队列 进行 操作 的 结果 ; 








尝试 发 送 消息 函数 

















尝试 发 送 消息 函数 的 流程 图 如 图 7-17 所 示 。 






2 消息 队列 满 ? 





5 线程 唤醒 成 功 ? 














7-17 尝试 发 送 消息 函数 流程 图 








流程 图 分 析 : 











STEP2 ”检查 消息 队列 状态 是 否 为 满 。 

STEP3 如 果 是 ， 则 判断 消息 队列 是 否 为 空 。 

STEP4 如 果 是 ， 则 尝试 从 消息 队列 的 线程 阻塞 队列 中 唤醒 一 个 线程 。 
STEP5 判断 是 否 真 的 唤醒 了 一 个 线程 。 

STEP6 如 果 是 ， 则 将 消息 发 到 该 线程 。 

STEP7 如 果 不 是 ， 则 将 消息 发 到 消息 队列 。 

STEP8 重新 设置 消息 队列 状态 。 


STEP9 函数 返回 。 





从 图 7-17 中 可 以 看 出 ， 在 尝试 发 送 消息 时 ， 并 不 区 分 该 函数 是 被 线程 调用 还 是 被 |SR 调 用 。 这 个 函数 主要 是 操作 消息 队列 ， 消 息 队列 为 满 时 是 不 能 继续 发 送 的 ; 消息 队列 为 空 时 有 可 能 存在 阻塞 的 线程 。 
该 函数 的 伪 代 码 如 代码 清单 7-9 所 示 。 





代码 清单 7-9: 尝试 发 送 消 息 代码 演示 





二 
尝试 发 送 消息 
2. 1{ 


3 二 佐 


人 
5. 

a 
7 else if ( 
消息 队列 状态 为 空 ) 
8. { 

9. 

尝试 唤醒 写 阻塞 队列 中 的 一 个 线程 ; 
10. if ( 
唤醒 了 某 个 线程 ) 
Ji。 { 

12. 
人 


14. else 
15。 


16. 
保存 消息 到 消息 队列 
取消 宁 抬 化 消息 队列 关 太 : 


se 
设置 操作 结果 成 功 ; 
20. } 


六 else 
22. { 


23。 

保存 消息 到 消息 队列 ; 

24. 

取消 初始 化 消息 队列 状态 ; 
25: 

设置 人 人 果 成 区 





返回 操作 结果 ; 
} 





7.2.5 消息 广播 


当 有 多 个 任务 因为 不 能 接收 到 消息 而 阻塞 在 消息 队列 时 ， 可 以 通过 广播 方式 向 这 些 任务 发 送 相同 的 信息 ， 完 成 多 任务 的 同步 和 通信 。 消息 广 播 的 流程 图 如 图 7-18 所 示 。 














5 有 比 当前 线程 优先 级 更 
的 线程 解除 阻塞 ? 





许 线程 调 





10 返回 


图 7-18 消息 广播 流程 图 


流程 图 分 析 : 

STEP2 内核 进 入 临界 区 。 

STEP3 检查 消息 队列 状态 是 否 为 空 ， 如 果 不 为 空 ， 则 不 会 有 线程 因 无 法 接收 消息 而 被 阻塞 ， 函 数 可 以 直接 退出 。 

STEP4 把 消息 队列 的 线程 阻塞 队列 清空 ， 唤 醒 全 部 被 阻塞 的 线程 并 向 这 些 线程 发 送 同样 的 消息 。 保 持 消 息 队列 的 就 绪 属 性 。 

STEP5 在 清空 消息 队列 的 线程 阻塞 队列 时 ， 可 能 唤醒 了 比 当 前 线程 优先 级 更 高 的 线程 ， 如 果 有 ， 则 开始 检查 是 否 需要 进行 线程 调度 。 
STEP6 判断 该 函数 是 否 被 线程 调用 。 

STEP7 判断 内 核 是 否 关闭 了 线程 调度 。 


STEP8 向 内 核发 出 线程 调度 请 求 。 






STEP9 内 核 退出 独占 区 ， 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线 程 调度 ; 如 果 是 在 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP10 函数 返回 。 


7.2.6 “线程 阻塞 解除 


线程 阻塞 在 消息 队列 的 线程 阻塞 队列 时 ， 可 以 是 无 限期 的 阻塞 直到 对 消息 队列 的 操作 成 功 ;或 者 有 期 限 的 等 待 ， 在 期 限 到 达 时 如 果 仍 然 无 法 成 功 则 自动 退出 阻塞 。 这 里 的 终止 消息 队列 阻塞 线程 的 操作 
则 是 由 外 部 强制 线程 解除 阻塞 ， 提 供 了 另 一 种 方式 结束 线程 对 消息 队列 的 等 待 。 其 流程 图 如 图 7-19 所 示 。 

















图 7-19 ”解除 线程 阻塞 流程 图 
流程 图 分 析 : 
STEP2 ”内核 进入 临界 区 。 
STEP3 ”将 线程 从 消息 队列 的 线程 阻塞 队列 中 解除 阻塞 。 该 函数 会 检查 指定 的 线程 是 否 阻 塞 在 消息 队列 的 线程 阻塞 队列 中 。 
STEP4 判断 被 解除 阻塞 的 线程 的 优先 级 是 否 比 当前 线程 的 优先 级 高 。 
STEP5 ”如果 是 ， 则 检查 此 时 函数 是 不 是 在 线程 环境 运行 。 
STEP6 如 果 是 ， 则 检查 此 时 内 核 是否 允 许 线程 调度 。 
STEP7 如 果 允 许 ， 则 向 内 核发 出 线程 调度 请 求 。 
STEP8 内 核 退出 独占 区 。 


STEP9 函数 返回 。 


7.2.7 ”消息 队列 刷新 


消息 队列 刷新 和 消息 队列 取消 初始 化 很 像 ， 不 同 的 地 方 在 于 取消 初始 化 消息 队列 操作 会 导致 清空 消息 队列 的 线程 阻塞 队列 ， 还 会 把 消息 队列 设置 成 进入 非 初始 化 状态 ， 不 能 继续 使 用 。 如 果 希 望 继续 使 
用 则 只 能 再 次 初始 化 ; 而 消息 队列 刷新 则 只 是 将 消息 队列 线程 阻塞 队列 上 的 线程 全 部 唤醒 ， 这 样 的 消息 队列 就 像 刚 被 初始 化 后 的 情形 ， 可 以 继续 使 用 。 线 程 刷新 流程 图 如 图 7-20 所 示 。 








图 7-20 ”线程 刷新 流程 图 


流程 图 分 析 : 

STEP2 ”内核 进入 临界 区 。 

STEP3 首先 清空 ， 消 息 队 列 的 线程 阻塞 队列 唤醒 全 部 被 阻塞 的 线程 ， 保 持 消 息 队 列 的 就 绪 属 性 。 

STEP4 然后 检查 在 清空 消息 队列 的 线程 阻塞 队列 时 是 否 唤醒 了 比 当前 线程 优先 级 更 高 的 线程 。 

STEP5 如 果 是 ， 则 检查 该 函数 是 否 被 线程 调用 。 

STEP6 如 果 是 ， 则 判断 内 核 是 否 允 许 线程 调度 。 

STEP7 如 果 人 允许 ， 则 向 内 核发 出 线程 调度 请 求 。 

STEP8 内 核 退出 独占 区 ， 如 果 是 在 线程 环境 下 ， 退 出 后 可 能 发 生 线程 调度 ; 如 果 是 在 ISR 中 ， 内 核 不 处 理 任务 调度 事务 。 


STEP9 函数 返回 。 


7.3 ”消息 队列 应 用 演示 


7.3.1 ”线程 间 的 异步 数据 传输 





在 本 例 中 ， 消 息 被 定义 为 LED 的 控制 命令 。 两 个 线程 通过 消息 队列 ， 发 送 和 接收 消息 ， 从 而 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 其 中 主 控 线 程 不 停 地 以 非 阻塞 方式 发 送 消息 ， 每 次 发 送 消息 成 功 后 延 时 
休眠 1 秒 ; LED 线 程 则 不 停 地 以 阻塞 方式 尝试 接收 消息 ， 然 后 根据 消息 的 内 容 ， 即 LED 控 制 命令 来 点 亮 或 者 熄灭 [ED， 循 环 往复 。 





在 这 个 例 程 里 ，LED 线 程 和 主 控 线 程 的 数据 传输 是 单 向 的 ， 并 且 是 异步 的 。 即 主 控 线 程 的 运行 不 依赖 LED 线 程 ， 而 LED 线 程 的 执行 则 依赖 于 主 控 线程 发 送 的 消息 。 程 序 实现 如 代码 清单 7-10 所 示 。 





代码 清单 7-10: 消息 队列 应 用 例 程 1 





1. #include "example.h" 

2. #include "trochili.h" 

3. #include "evb bsp.h" 

4. 

5. #if (EVB EXAMPLE == CH7 MESSAGE FEXRAMPLE1) 
6. 

了 

用 户 线程 参数 */ 

8. #define THREAD LED STACK SIZE (256*2) 
9. #define THREAD LED PRIORITY (7) 

10. #define THREAD LED SLICE (20) 
Ts 


12. #define THREAD CTRL STACK SIZE (256*2) 
13. #define THREAD CTRL PRIORITY (6) 

14. #define THREAD CTRL SLICE (20) 
15, 


6 As 

用 户 线程 定义 */ 

17. static TThread ThreadLED; 

18. static TThread ThreadcTRL; 

0 

用 户 线程 栈 定义 */ 

21. static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
22. static TWord ThreadCTRLStack[THREAD CTRL STACK SIZE]; 








3 

24. /* 

用 户 消息 类 型 定义 */ 
25. typedef struct 
26. { 

RT TWord Index; 
28. TWord Value; 


29. } TLEDMsg; 





32. #define MO POOL LEN (32) 

33. static void* LedMsgPool [MO POOL LEN]; 
34. static TMsgQueue LedMO; 

35。 

36，/* 

用 户 消息 定义 */ 

37. static TLEDMsg LedMsg; 

38. 

39. < LET 

线程 的 主 函 数 */ 

40. static void ThreadLEDENntry (void* pArg) 





3 下 

42. TErrno errno; 
43. TState state; 
44. TLEDMsg* pMsg; 
45. 

46. while (eTrue) 
47. 


48 . /* LED 

线程 以 阻塞 方式 接收 消息 ， 如 果 成 功 则 按照 消息 的 内 容 来 点 亮 或 者 熄灭 LED */ 
49 . state = TclReceiveMessage (&LedMQ， (void**) (gpMsg), 
50 . IPC OPT WAIT, 0, &errno); 
1 if (state 一 eSuccess) Se 








{ 
53. EVB_LEDControl (pMsg->Index, pMsg->Value); 


en 
主 控 线 程 的 主 函 数 */ 
60. static void ThreaqCTRLEntry (void* pArg) 


61. { 

62. TErrno errno; 

3 TLEDMsg* pMsg = &LedMsg; 
64. while (eTrue) 

65. { 

66. 


/* 
按照 阻塞 方式 发 送 LED 
消息 */ 

PMsg->Index = LED1; 

pMsg->Value = LED ON; 

TclSendMessage (&LedMO, (TMessage*) (gpMsg), IPC OPT WAIT, 0, &errno); 





71. 1* 

主 控 程 序 延 时 1 

秘 */ 

了 2。 TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 
73. 


74. 


/* 
程序 按照 阻塞 方式 发 送 LED 
熄灭 的 消息 */ 
















3 PMsg->Index = LED1; 
76. PMsg->Value = LED OFF; 
7s TclSendMessage (&LedMO， (TMessage*) (&pMsg), IPC OPT WAIT, 0, &errno); 
78. 
2 
程序 延 时 1 
黎 
80 . TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 
21 } 
82. 
83. 
84. 


85。 /* 

用 户 应 用 程序 入 口 函数 */ 

86. static void APP LEDEntry (void) 
7 

88. TErrno errno; 

89. 


90 . i 
配置 使 能 评估 板 上 的 LED 
设备 */ 


91. EVB_LEDConfig () 7 
92 


83。 J 

初始 化 消息 队列 */ 

94. TclInitMsgQueue (&LedMO, (void**) (&gLedMsgPool), 

95. MO _POOL LEN, IPC PROP NONE, gerrno); 
96. 

97; Ry 

初始 化 LED 

设备 控制 线程 */ 

98. TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
49。 ThreadLEDStack, THREAD LED STACK SIZE, 
100. THREAD LED PRIORITY, THREAD LED SLICE); 
101. 

102. 六 


初始 化 CTRL 
线程 */ 








103. TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
104. ThreadCTRLStack, THREAD CTRL STACK SIZE, 
105. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
106. 

107. 人 

激活 LED 

线程 */ 

108 . TclActivateThread (&ThreadLED) 

109 . 

110. Kw 

激活 主 控 线程 */ 

ja TclActivateThread (&ThreadCTRL); 

了 全 

113% 

114. 

115:/* 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

116.int main (void) 

Li 

118. J 

注册 处 理 器 初始 化 函数 到 内 核 */ 

119 TclSetCpuEntry (&CPU_STM32F10xInit); 
120, 

i121, 

注册 板 级 初始 化 函数 到 内 核 */ 

122 TclSetBoardEntry (&EVB_SetupBoard); 
二 235 

124. Li 

注册 板 级 调试 打印 函数 到 内 核 */ 

125. TclSetTraceRoutine (&EVB UartlWriteString); 
126. 

127 J 

注册 用 户 初始 化 函数 到 内 核 */ 

128 TclSetUserEntry (&APP LEDENtry); 

1 2 

六 4 

131. TclStartKernel (); 

32 

133 return 1; 

134.} 

L395s 

136.#endif 

















程序 运行 后 ，LED 的 变化 如 图 7-21 所 示 。 
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ee 
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--J]--- 
1 
ds 
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7-21 








LED 的 变化 情况 





7.3 ”消息 队列 应 用 演示 


7.3.1 ”线程 间 的 异步 数据 传输 





在 本 例 中 ， 消 息 被 定义 为 LED 的 控制 命令 。 两 个 线程 通过 消息 队列 ， 发 送 和 接收 消息 ， 从 而 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 


其 中 主 控 线程 不 停 地 以 非 阻塞 方式 发 送 消息 ， 每 次 发 送 消息 成 功 后 延 时 











休眠 1 秒 ; LED 线 程 则 不 停 地 以 阻塞 方式 尝试 接收 消息 ， 然 后 根据 消息 的 内 容 ， 即 LED 控 制 命令 来 点 亮 或 者 熄灭 [ED， 循 环 往复 。 

在 这 个 例 程 里 ，LED 线 程 和 主 控 线程 的 数据 传输 是 单 向 的 ， 并 且 是 异步 的 。 即 主 控 线程 的 运行 不 依赖 LED 线 程 ， 而 LED 线 程 的 执行 则 依赖 于 主 控 线程 发 送 的 消息 。 程 序 实现 如 代码 清单 7-10 所 示 。 
代码 清单 7-10: 消息 队列 应 用 例 程 1 

1. #include "example.h" 

2. #include "trochili.h" 

3. #include "evb bsp.h" 

4. 

5. #if (EVB EXAMPLE == CH7 MESSAGE EXAMPLE]) 

Bi 

J 

用 户 线程 参数 */ 

8. #define THREAD LED STACK SIZE (256*2) 

9. #define THREAD LED PRIORITY (7) 

10. #define THREAD LED SLICE (20) 

Ts 

12. #define THREAD CTRL STACK SIZE (256*2) 

13. #define THREAD | CIRL, 1 PRIORITY (6) 


14. #define THREAD CTRL SLICE (20) 

5 

8s 2 

用 户 线程 定义 */ 

17. static TThread ThreadLED; 

18. static TThread ThreagCTRL; 

49 

QD sy 

用 户 线程 栈 定义 */ 

21. static TWord ThreadqLPDStack[THREAD LED STACK SIZE]; 
22. static TWord ThreadCTRLStack [THREAD CTRL : STACK SIZE]; 
3 


闪光 
用 户 消息 类 型 定义 */ 
25. typedef struct 


2 东 

TWord Index; 
2 TWord Value; 
29. } TLEDMsg; 

30 . 

3T 1 


用 户 消息 队列 定义 */ 

32. #define MO POOL LEN (32) 

33. static void* LedMsgPool [MO POOL LEN]; 
34. static TMsgQueue LedMo; - 





35s 

36. 

用 户 消 息 定义 */ 

37. static TLEDMsg LedMsg; 
38 . 

39。V/x* LED 


线程 的 主 函 数 */ 
40. static void ThreadLEDFEntry (void* pArg) 





41. { 

42. TErrno errno; 
43. TState state; 
44. TLEDMsg* pMsg; 
45. 

46. while (eTrue) 
a 


/* LED 

旧式， 如 果 成 功 则 按照 消息 的 内 容 来 点 亮 或 者 熄灭 LED */ 
state = TclReceiveMessage (&LedMO, (void**) (gpMsg), 

Ee IPC OPT WAIT, 0, &errno); 

SE if (state 一 eSuccess) 

D2 

5 EVB_LEDControl (pMsg->Index, pMsg->Value); 

54. } 

353 } 

56. } 

37 

58. 

9 

这 给 程 的 主 数 

60. static void ThreadCTRLENtry (void* pArg) 

{ 

















TErrno errno; 
TLEDMsg* pMsg = &LedMsg; 
while (eTrue) 





PMsg->Index = LED]1; 
PMsg->Value = LED ON; 
TclSendMessage (&LedMO, (TMessage*) (&pMsg), IPC OPT WAIT, 0, 


四 














主 控 程 序 延 时 1 

秒 */ 

es TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 
语素 方式 人 Ta 

由 交加 并 

Ds Si = LED1; 

2 PMsg->Value = LED OFF; 

ET TclSendMessage (&LedMO， (TMessage*) (gpMsg), IPC OPT WAIT, 0, 

78. 

3 a 

下 延 时 1 

称 : 尖 

80 . TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 

81 . } 

32; |} 

3 

0 


怖 志 应 用 程序 入 口 函数 */ 
86. static void APP LEDEntry (void) 





7 
88 . TErrno errno; 
9 
90 . 7 二 
配置 使 能 评估 板 上 的 LED 
设备 */ 
91 . EVB LEDConfig () 7 
92. 5 
93。 /* 
初始 化 消息 队列 */ 
94. TclInitMsgQueue (&LedMO, (void**) (gLedMsgPool), 
95. MO_POOL, LEN, IPC PROP NONE, &errno); 
96. 
Wr i 
初始 化 LED 
设备 控制 线程 */ 
98. TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
995 ThreagdLEDStack, THREAD LED STACK SIZE, 
100. THREAD LED PRIORITY, THREAD LED SLICE); 
OT 
492 人 
初始 化 CTRL 
线程 */ 
J TclInitThread (&ThreadCTRL， &ThreadCTRLENtry, (void*)NULL, 
104. ThreadcTRLStack, THREAD CTRL STACK SIZE, 
105. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
106. 
107. J 
笑 


TclActivateThread (&ThreadLED); 






有 
E 控 线程 */ 
TclActivateThread (&ThreadCTRL); 





a ey 
处 理 器 BOOT 

之 后 会 调用 main 
函数 ， 必 须 提供 * 


116.int main (void) 


内 

118 . Li 

注册 处 理 器 初始 化 函数 到 内 核 */ 

和 可 TclSetCpuEntry (&CPU_STM32F10xInit) 7 
0 


hs 


&errno); 


&errno); 


注册 板 级 初始 化 函数 到 内 核 */ 


IT22， TclSetBoardEntry (&EVB_SetupBoard); 
123; 

124. 

其 放 衣 级 滑 江 打印 函数 到 内 核 */ 

125, TclSetTraceRoutine (&EVB UartlWritesString); 
i126. 

127。 J 

注册 用 户 初始 化 函数 到 内 核 */ 

128 . TclSetUserEntry (&APP LEDENtry); 
129, 

130. Ei 

启动 内 核 */ 

bs TclStartKernel (); 

32 

133. return 1; 

134.} 

135, 

136.#endif 

















程序 运行 后 ，LED 的 变化 如 图 7-21 所 示 。 
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7.3.2 ”线程 和 ISR 间 的 异步 数据 传输 
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LED 的 变化 情况 





在 本 例 中 ， 消 息 被 定义 为 LED 的 控制 命令 。 一 个 LED 线 程 通过 消息 队列 接收 消息 ， 消 息 的 内 容 决 定 LED 的 点 亮 或 者 熄灭 。 用 户 通 过 外 部 按键 中 断 来 激活 KeylSR， 在 该 1SR 中 ， 会 交 蔡 发 送 LED 点 亮 和 熄灭 














的 消息 ， 从 而 实现 LED 按 照 用 户 按键 的 操作 点 亮 和 熄灭 。 











在 这 个 例 程 里 ，LED 线 程 和 KeylSR 的 数据 传输 是 单 向 的 ， 并 且 是 异步 的 。LED 线 程 的 执行 则 依赖 于 KeylSR， 而 KeylSR 的 运行 是 不 确定 的 。 程 序 实现 如 代码 清单 7-11 所 示 。 


代码 清单 7-11: 消息 队列 应 用 例 程 2 


1. #include"example.h" 
2. #include "trochili.h" 
3. #includerevb bsp.h" 
4. 
5. #if (EVB EXAMPLE == CH7 MESSAGFE FXAMPLE2) 
6. 
了 7 
Pe 参数 */ 

#define THREAD LED STACK SIZE (256) 
加 #define THREAD LED PRIORITY (7) 
10. #define THREAD LED SLICE (20) 
hs 


12. #define THREAD CTRL STACK SIZE (256) 
13. #define THREAD CTRL PRIORITY (6) 
14. #define THREAD CTRL SLICE (20) 
15, 


5 

用 户 线程 定义 */ 

17. static TThread ThreadLED; 
18. static TThread ThreadCTRL; 


19. 
20: 7/* 
A 栈 定义 */ 


21. static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
222 。 

Es 

种 洛 息 类 型 定义 */ 

24. typedef struct 


5 法 

26. TWord Index; 
ls TWord Value; 
28. } TLEDMsg; 

29。 

0 2 


用 户 消息 队列 定义 */ 

31. #define MO POOL LEN (32) 

32. static TMsgQueue LedMO; 

33. static void* LedMsgPool [MO POOL LEN]; 
34. 

35. A* 

用 户 消息 定义 */ 

36. static TLEDMsg LedMsg; 

3 

38。/* LED 

线程 的 主 函数 */ 

39. static void ThreadLEDEnNtry (void* pArg) 
40. { 

41. TErrno errno; 


42. TState state; 


43. TLEDMsg* pMsg; 
44. 

45: while (eTrue) 
46. { 


47. /* LED 
线程 以 阻塞 方式 接收 消息 ， 如 果 成 功 则 按照 消息 的 


48 . 

内 容 来 点 亮 或 者 熄灭 LED */ 

49. state = TclReceiveMessage (&LedMO, (void**) (gpMsg), 
SO IPC OPT WAIT, 0, &errno); 
51. if (state == eSuccess) Bi 

S52 { 

53 EVB_LEDControl (pMsg->Index, pMsg->Value); 

54. } 

55: } 

56. } 

57: 

SH tt 

评估 板 按键 中 断 处 理 函 数 */ 

59. static void EVB_KeyISR (TVector vector, TProperty Property, TWord data) 





60. { 
Gl: TLEDMsg* pMsg = &LedMsg; 
2 static TWord turn = 0; 
63。 
64. if (EVB KeyScan()) 
65. . 
if (turn % 2) 
/* KeyISR 
PMsg->Index = LED]1; 
PMsg->Value = LED ON; 
TclIsrSendMessage (&LedMO, (TMessage*) (&PMsg) ，0) 
i 
else 
/* KeyISR 
发 送 LED 
熄灭 的 消息 */ 
3 了 6， PMsg->Index = LED1; 
了 PMsg->Value = LED OFF; 
78. TclIsrSendMessage (&LedMO, (TMessage*) (&pMsg), 0); 
74: $ 
80. turntt? 
81. } 
82. 1} 
83. 


Ba 
用 户 应 用 程序 入 口 函数 */ 
85. static void APP LEDEntry (void) 


86. { 

7 TErrno errno; 
88. 

89. Re 

配置 使 能 评估 板 上 的 LED 

和 KEY 

设备 */ 

90 . EVB_ LEDConfig () 7 
91. EVB_ KeyConfig(); 
92. 

93 . FR 

设置 和 KEY 


相关 的 外 部 中 断 向 量 */ 
94 TclSetIntVector (KEY_INT VECTOR, &EVB KeyISR, 0); 
95, 


96. A 
初始 化 消息 队列 */ 
97 TclInitMsgQueue (&LedMO, (void**) (&gLedMsgPool), 


98. MQ_POOL LEN, IPC PROP NONE, &errno); 
9 

100. 

初始 化 LED 

设备 控制 线程 */ 

04 TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 


ThreadLEDStack, THREAD LED STACK SIZE, 
THREAD LED PRIORITY, THREAD LED SLICE); 


TclActivateThread (&ThreadLED); 











y 
激活 主 控 线程 */ 
109. TclActivateThread (&ThreadCTRL); 
Tl0:} 
T1114 
i12: 
ph he a 
处 理 器 BOOT 
之 后 会 调用 main 
函数 ， 必 须 提供 */ 
114.int main (void) 
T15.f 
116. Li 
注册 处 理 器 初始 化 函数 到 内 核 */ 
ET TclSetCpuEntry (&CPU_STM32F10xInit); 
18. 
119. 了 
注册 板 级 初始 化 函数 到 内 核 */ 
120 . TclSetBoardEentry (&EVB_SetupBoard); 
i121 
二 22 。 
注册 板 级 调试 打印 函数 到 内 核 */ 
123: TclSetTraceRoutine (&EVB UartlWriteString); 
124. 
125., 和 
注册 用 户 初始 化 函数 到 内 核 */ 
126. TclSetUserEntry (&APP LEDENtry); 
121s 
128, Fe 
启动 内 核 */ 
129, TclStartKernel (); 
30. 
L341。 rot 17 
T32 
133 . 
134.#endif 





这 个 例子 不 方便 做 图 示 ， 请 读者 自己 动手 操作 。 





7.3.3 ”线程 间 的 单 向 同步 数据 传输 








在 本 例 中 ， 消 息 被 定义 为 LED 的 控制 命令 。 两 个 线程 通过 消息 队列 ， 发 送 和 接收 消息 ， 从 而 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 不 过 和 前 面 的 例子 不 同 的 是 ， 增 加 了 一 个 信号 量 进 行 两 个 线程 的 同步 。 
E 控 线程 不 停 地 以 非 阻塞 方式 发 送 消息 ， 每 次 发 送 消息 成 功 后 则 停止 运行 ， 等 待 信号 量 ;LED 线 程 则 不 停 地 以 阻塞 方式 尝试 接收 消息 ， 然 后 根据 消息 的 内 容 ， 即 LED 控 制 命令 来 点 亮 或 者 熄灭 LED。 不 过 

















其 中 





只 有 当 LED 线 程 释放 信号 量 后 控制 线程 才能 继续 运行 。 


在 这 个 例 程 里 ，LED 线 程 和 主 控 线程 的 数据 传输 是 单 向 的 ， 但 运行 确 是 同步 的 。 


代码 清单 7-12: 消息 队列 应 用 例 程 3 


单 7-12 所 





即 主 控 线 程 的 运行 依赖 LED 线 程 释放 信号 量 ; 而 LED 线 程 的 执行 则 依赖 于 主 控 线程 发 送 消息 。 程 序 实现 如 代码 清 





1. #include "example.h" 
2. #include "trochili.h" 
3. #include "evb bsp.h" 
4. 
5. #if (EVB EXAMPLE == CH7 MESSAGE EXAMPLE3) 
6. 
7 
有 参数 */ 
#define THREAD LED STACK SIZE (256*2) 
2 #define THREAD LED PRIORITY (7) 
10. #define THREAD LED SLICE (20) 
11s 


12. #define THREAD CTRL STACK SIZE (256*2) 
13. #define THREAD CTRL PRIORITY (6) 

14. #define THREAD CTRL SLICE (20) 
5。 


A 

用 户 线程 定义 */ 

17. static TThread ThreadLED; 
18. static TThread ThreadcTRL; 
1 

0 A 

用 户 线程 栈 定义 */ 


21. static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
22. static TWord ThreadCcTRLStack[THREAD CTRL STACK SIZE]; 


23. 

a 

用 户 消息 类 型 定义 */ 
25. typedef struct 


26. { 

> TWord Index; 
28. TWord Value; 
29. } TLEDMsg; 

30. 

3 


居 疡 汉 息 队 列 定义 */ 

32. #define MO POOL LEN (32) 

33. static TMsgQueue LedMO; 

34. static void* LedMsgPool [MO POOL LEN]; 
35， 

36。/* 

用 户 消息 定义 */ 

37. static TLEDMsg LedMsg; 

38 . 

hy 

用 户 信号 量 定义 */ 

40. static TSemaphore LedSemaphore; 








41. 
42. /* LED 
的 线程 的 主 函数 */ 








43. static void ThreadLEDEntry (voidx pArg) 
44. { 

45. TState state; 

46. TLEDMsg* pMsg; 

47. TErrno errno; 


49. while (eTrue) 
/* LED 
2 :0 宗方 式 食 届 滑 电 a 


state 


ee (&LedMo, 


(void**) (&PMsg) ， 


2 IPC OPT WAIT, 0, &errno); 


54. if (state = eSuccess) 
55, { 


56. 
如 果 成 功 则 按 四 
57. 
58. 


59 
线程 休眠 1 
秒 */ 






60 . TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 


Gl 
GA 
线程 释放 信号 量 */ 
3s 


64. } 

65. } 

66. } 

67. 

68. 

~ le 

主 控 线 程 的 主 函 数 */ 

70. static void ThreaqdCTRLEntry (void* pArg) 
Ths 


/* LED 


TErrno errno; 
TLEDMsg* pMsg = &LedMsg; 
while (eTrue) 


{ 
以 阻塞 方式 发 送 LED 


PMsg->Index = LED]1; 
PMsg->Value = LED ON; 








这 线程 以 旧 案 分 式 获得 信号 量 */ 








/* 
程 以 阻塞 方式 发 送 TED 
蚌 *#/ 


PMsg->Index = LED]1; 
PMsg->Value = LED OFF; 






入 有 方式 得 信号 量 */ 





} 


用 户 成 用 入 口 函数 */ 
96. static void APP LEDEntry (void) 


3 

98. TErrno errno; 

99。 

100 . 人 当 

配置 使 ee 
设备 * 

101. EVB LEDConfig(); 
102. 加 


103, A 


TclReleaseSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 


TclSendMessage (&LedMO, (TMessage*) (gpMsg), IPC OPT WAIT, 0 , &errno); 


全。 TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, IPC OPT NONE, &errno); 


TclSendMessage (&LedMO， (TMessage*) (gpMsg), IPC OPT WAIT , 0, &errno); 


TclObtainSemaphore (&LedSemaphore, IPC OPT WAIT, 0, &errno); 














初始 化 消息 队列 和 信号 量 */ 

104. TclInitMsgQueue (gLedMO, (void**) (&LedMsgPool) ， 

105. MO _POOL LEN, IPC PROP NONE, &errno) ， 
106. TclInitSemaphore (&LedSemaphore, 0, 1, IPC PROP NONE, &errno); 
L107: 

108. Wf 

初始 化 LED 

设备 控制 线程 */ 

109. TclInitThread(&ThreadLED, &ThreadLEDENntry, (void*)NULL, 
LI: ThreagdLEDStack, THREAD LED STACK SIZE, 
Tt THREAD LED PRIORITY, THREAD LED SLICE); 
12 

113。 fn 

初始 化 CTRL 

线程 */ 

114. TclInitThread(&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
L153 ThreadCTRLStack, THREAD CTRL STACK SIZE, 
116. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
i117s 

118. Py 

激活 LED 

线程 */ 

二 395 TclActivateThread (&ThreadLED); 

120. 

121.s j 

激活 主 控 线 程 */ 

122, TclActivateThread (&ThreadCTRL); 

123. } 

124. 

a. /* 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

126. int main (void) 

i27a 1 

128: A 

注册 处 理 器 初始 化 函数 到 内 核 */ 

129. TclSetCpuEntry (&CPU_STM32F10xInit); 

130。 

T31。 

注册 板 级 初始 化 函数 到 内 核 */ 

132， TclSetBoardEntry (&EVB SetupBoard) 7 

工 33。 

134. A 

注册 板 级 调试 打印 函数 到 内 核 */ 

二 39。 TclSetTraceRoutine (&EVB_Uart1WriteString) 7 

T35。 

本 了 7 jg 

注册 用 户 初始 化 函数 到 内 核 */ 

138 . TclSetUserEntry (&APP LEDENtry); 

139. 

140. A 

启动 内 核 */ 

1aA1 TclStartKernel (); 

142. 

143. return 1; 

144. } 

145. 

146. #endif 








程序 运行 后 ，LED 的 变化 如 图 7-22 所 示 。 
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7.3.4 ”线程 间 的 双向 同步 数据 传输 








7-22 LED 的 变化 情况 




















在 本 例 中 ， 我 们 通过 两 个 线程 的 同步 配合 ， 实 现 两 个 LED 分 别 按照 1 秒 的 间隔 点 亮 和 熄 炎 。 这 里 使 











了 两 个 信号 量 。 





LED 线 程 0 首先 以 阻塞 方式 从 消息 队列 0 读 取 消息 ， 然 后 根据 消息 内 容 点 亮 或 者 熄灭 LED0;， 随 后 延 时 1 秒 ; 最 后 再 以 阻塞 方式 向 消息 队列 1 中 发 送 消息 。 





LED 线 程 1 首先 以 阻塞 方式 从 消息 队列 1 读 取 消息 ， 然 后 根据 消息 内 容 点 亮 或 者 熄灭 LED0; 最 后 以 | 


明 塞 方式 向 消息 队列 0 中 发 送 消息 。 


在 这 个 例 程 里 ， 两 个 LED 线 程 的 现实 了 双向 同步 的 ， 即 LED 线 程 1 的 运行 依赖 LED 线 程 2;LED 线 程 2 的 执行 也 依赖 于 LED 线 程 1， 因 为 它们 的 运行 都 依赖 于 某 个 消息 队列 的 操作 。 程 序 实现 如 代码 清和 


所 示 。 


代码 清单 7-13: 消息 队列 应 用 例 程 4 





7-13 








1. #include "example.h" 
2. #include "trochili.h" 


#include "evb bsp.h" 


#if (EVB EXAMPLE == CH7_MESSAGE EXAMPLE4) 


/* 
j 户 线程 参数 */ 
#define THREAD LED STACK SIZE (256*2) 


#define THREAD LED PRIORITY (7) 
0. #define THREAD LED SLICE (20) 
1 
时 二 六 下 
日 户 线程 定义 */ 


3. static TThread ThreadqLED17 
4. static TThread ThreadLED2; 


On 


6. As 

户 线程 栈 定义 */ 

7. static TWord ThreadLED1Stack[THREAD LED STACK SIZE]7 
8. static TWord ThreadLED2Stack[THREAD LED STACK SIZE]; 


MO 


DR 
户 消息 类 型 定义 */ 
21. typedef struct 


河马 已 号 忆 泗 RCEEC oIN nr 








2 

3 TWord Index; 
24. TWord Value; 
25. } TLEDMsg; 

26. 

2 


生计 4 
#define MO POOL LEN (32) 
2 static TMsgQueue LedMol1; 
30. static TMsgQueue LedMO2; 
31. static void* LedlMsgPool [MQ POOL LEN]; 
32. static void* Led2MsgPool [MO POOL LEN]; 
33 
ee 
用 户 消息 定义 */ 
35. static TLEDMsg LedMsgl; 
36. static TLEDMsg LedMsg2; 








3 
38; /* TIED1 
的 线程 的 主 函数 */ 
39. static void ThreadLED1Entry (void* pArg) 
40. { 
41. TErrno errno; 
42. TLEDMsg* pMsgl = &LedMsg17 
43. TLEDMsg* pMsg2 = &LedMsg2; 
44. 
45 . while (eTrue) 
46. { 
/* LED1 
家 旧式 EDn 
消息 





PMsg2->Index = LED2; 

PMsg2->Value = LED ON” 

S05 TclSendMessage (&LedMO2, (void**) (&gpMsg2), IPC OPT WAIT, 0, &errno); 
2 


已 式 扩 和 ， 根 据 消息 内 容 来 点 亮 或 者 熄灭 LED1 */ 
TClReceiveMessage (&LedMOl， (void**) (&pMsg1), IPC OPT WAIT, 0, &errno); 


2 EVB_LEDControl (pMsgl->Index, pMsgl->Value); 

59 

56 . PMsg2->Index = LED2; 

57. PMsg2->Value = LED OFF; 

58. TclSendMessage (&LedMO2, (void**) (&gpMsg2), IPC OPT WAIT, 0, &errno); 
/* LED1 


入 入 方式 人 民有， 根据 消息 内 容 来 点 亮 或 者 熄灭 LED1 */ 
TclReceiveMessage (&LedMQ1， (void**) (gpMsg1), IPC OPT WAIT, 0, &errno); 
i EVB_LEDControl (pMsgl->Index, pMsgl->Value); ,0 
63. 和 
64. } 
65. 
66. 
67. /* LED2 
线程 的 主 函数 */ 
68. static void ThreadLED2Entry (void* pArg) 





69. { 

70. TErrno errno; 

ks TLEDMsg* pMsgl = &LedMsg17 
2 TLEDMsg* pMsg2 = &LedMsg2; 
3 

74. while (eTrue) 


/* LED2 
和 ma 息 ， 根 据 消息 内 容 来 点 亮 或 者 熄灭 LED2 */ 
TclReceiveMessage (&LedMO2， (void**) (&pMsg2), IPC OPT WAIT, 0, &errno); 








和 EVB_LEDControl (pMsg2->Index, pMsg2->Value); 
9 
80. /* LED2 
线程 延 时 1 
秒 */ 
81. TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 
82. 
83. /* LED2 
线程 以 阻塞 方式 发 送 LED1 
点 亮 消 息 */ 
84. PMsgl->Index = LED17 
5 PMsg1->Value = LED ON; 
86. TclSendMessage (&LedMQO1， (void**) (gpMsg1), IPC OPT WAIT, 0, &errno); 
Ss 
88. /* LED2 
线程 以 阻塞 方式 接收 消息 ， 根 据 消息 内 容 来 点 亮 或 者 熄灭 LED2 */ 
89. TclReceiveMessage (&LedMO2, (void**) (&pMsg2), IPC OPT WAIT, 0, &errno); 
90. EVB_LEDControl (pMsg2->Index, pMsg2->Value); 
|、 
92 . /* LED2 
线程 延 时 1 
秒 */ 
TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 
/* LED2 
引 和 有 守 太 式 人 二 TSDs 
熄灭 消息 */ 
96 . PMsg1->Index = LED17 
375 PMsg1->Value = LED OFF; 
98 . TclSendMessage (&LedMQO1， (void**) (gpMsg1), IPC OPT WAIT, 0, &errno); 
995 1 
二 OU 
101. 
102 . 
I03.7* 


用 户 应 用 入 口 函 数 */ 
104.static void APP LEDEntry (void) 


105%14 

106. TErrno errno; 

107. 

108. J 

配置 使 能 评估 板 上 的 LED 

设备 */ 

109, EVB LEDConfig(); 

110. 

TT 六 

初始 化 消息 队列 */ 

112. TclInitMsgQueue (&LedMO1, (void**) (&Led1MsgPool) ， 
113. MO _POOL, LEN, IPC PROP NONE, &errno); 
114. 


TIS TclInitMsgQueue (&LedMO2, (void**) (&Led2MsgPool)， 


116. MQ_POOL LEN, IPC PROP NONE, &errno); 
117. 








118. /* 

初始 化 LED 

设备 控制 线程 1 */ 

119. TclInitThread (&ThreadLED1， &ThreadLED1Pntry， (void*)NULL, 
120.. ThreadLED1Stack, THREAD LED STACK SIZE, 
2 THREAD LED PRIORITY, THREAD LED SLICE); 
122. 

123. we 

初始 化 LED 

设备 控制 线程 2 */ 

124. TclInitThread (&ThreadLED2, &ThreadLED2EnNntry, (void*)NULL, 
i125. ThreadLED2Stack, THREAD LED STACK SIZE, 
126 THREAD LED PRIORITY, THREAD LED SLICE); 
2 

128. 

激活 LED 

线程 1 */ 

129. TclActivateThread (&ThreadLPD1) 7 

i130. 

131。 人 

激活 LED 

线程 2 */ 

F326 TclActivateThread (&ThreadLPD2) 7 

133.¥ 

134. 

135./* 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

136.int main (void) 

i374 

138. Ei 

注册 处 理 器 初始 化 函数 到 内 核 */ 

139. TclSetCpuEntry (&CPU_STM32F10xInit); 

140. 

141. 了 

注册 板 级 初始 化 函数 到 内 核 */ 

142 . TclSetBoardEentry (&EVB_SetupBoard); 

143. 

144. Re 

注册 板 级 调试 打印 函数 到 内 核 */ 

145.。 TclSetTraceRoutine (&EVB UartlWriteString); 

146. 

147. Li 

注册 用 户 初始 化 函数 到 内 核 */ 

148 . TclSetUserEntry (&APP LEDENtry); 

149. 

150. J 

启动 内 核 */ 

151 TclStartKernel (); 

152 。 

535 rote 1 

154.} 

155, 

156.#endif 





息 队 肌 





程序 运行 后 ，LED 的 变化 如 图 7-23 所 示 。 
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7.3.5 “多 线程 同步 与 消息 队列 刷新 














时 间 


7-23 LED 的 变化 情况 


在 本 例 中 ， 实 现 多 个 LED 线 程 和 1 个 控制 线程 的 单 向 同步 (没有 数据 传输 ) 。 实 现 三 个 LED 分 别 按照 1 秒 的 间隔 点 亮 和 熄灭 。 这 里 使 用 了 1 个 消息 队列 。 





代码 清单 7-14: 消息 队列 应 用 例 程 5 


#include "example.h" 
#inclugde "trochili.h" 
#include "evb bsp.h" 


#if (EVB EXAMPLE == CH7 MESSAGFE FXAMPLES) 


am wm 


人 
用 户 线程 参数 */ 

8. #define THREAD LED STACK SIZE (256) 
9. #define THREAD LED PRIORITY (7) 
10. #define THREAD LED SLICE (20) 
11. 


具体 实现 时 ， 多 个 LED 线 程 的 线程 函数 相似 ， 都 是 以 阻塞 方式 从 同一 消息 队列 读 取 消息 ， 
进行 一 次 刷新 操作 ， 使 得 那些 阻塞 在 消息 队列 的 线程 阻塞 队列 上 的 线程 都 解除 阻塞 。 代 码 实现 如 代码 清单 7-14 所 示 。 




















的 是 阻塞 在 消息 队列 的 线程 阻塞 队列 上 ， 使 得 多 个 线程 的 执行 路 径 交 汇 在 一 起 。 而 控制 线程 则 是 每 隔 1 秒 对 消 











12. #define THREAD CTRL STACK SIZE (256) 
13. #define THREAD CTRL PRIORITY (6) 
14. #define THREAD CTRL SLICE (20) 
15 
6; 
tn 定妆 可/ 
static TThread ThreadLED17 
i static TThread ThreadLED2; 
19. static TThread ThreadLED37 
20. static TThread ThreadcTRL; 
2 


当世 大 家 

用 户 线程 栈 定义 */ 

23. static TWord ThreadLED1Stack 
24. static TWord ThreadLED2Stack 
25. static TWord ThreadLED3Stack 
26. static TWord ThreadCTRLStack 
Zs 

28 . 

用 六 息 类 型 定 义 A 

29. typedef struct 


30% 

S81; TWord Index; 
SR TWord Value; 
33. } TLEDMsg; 

34. 

3 





用 户 消息 队列 定义 */ 

36. #define MO POOL LEN (32) 

37. static TMsgQueue LedMO; 

38. static void* LedMsgPoo] [MO POOL LEN]; 
39: 

40 . 

41. /* LED1 

线程 的 主 函数 */ 

42. static void ThreagdLEDlEntry (void* pArg) 
43. { 


44. TState state; 
45. TLEDMsg* pMsg; 
46. TErrno errno; 
47. 

48 . while (eTrue) 
49. 

50. /* LED3 


线程 以 阻塞 方式 接收 消息 ， 如 果 发 现 消息 队列 FLUSH 
则 熄灭 LED3 */ 


THREAD LED STACK SIZE]; 
THREAD LED STACK SIZE]; 
THREAD LED STACK SIZE]; 
THREAD CTRL STACK SIZE] 


SL state = TclReceiveMessage (&LedMO, (void**) (gpMsg), 
SR IPC OPT WAIT, 0, &errno); 
3 if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 
54. { 
05 EVB_LEDControl (LED1, LED ON); 
56 . 4 
Ds 

/* LED3 


且 让 以 阻塞 方式 接收 消息 ， 如 果 发 现 消息 队列 FLUSH 
则 点 亮 LED3 */ 


S93 state = TclReceiveMessage (&LedMO, (void**) (gpMsg) 


1 
60 . IPC OPT WAIT, 0, &errno); 
61. if ((state != eSuccess) && (errno & ERR IPC FLUSH) 


62. 
63. EVB LEDControl (LED1, LED OFF); 
64. } = 
65. 1 
66. } 
67. 
68. /* LED2 
的 线程 的 主 函数 */ 
69. static void ThreadLED2Entry (void* pArg) 
3 了 90。 于 





Rs TState state; 
J TLEDMsg* pMsg; 
3 TErrno errno; 
74. 
23, while (eTrue) 
35: { 

/* LED3 


发 让 以 阻 天方 式 技 收 东 息 ， 如 果 发 现 消息 队列 FLUSH 
则 熄灭 LED3 */ 


) 


3 state = TclReceiveMessage (&LedMQO， (void**) (&pMsg), 
2 IPC OPT WAIT, 0, &errno); 
80. if ((state != eSuccess) && (errno & ERR IPC FLUSH) 
81. f 
Bs EVB_LEDControl (LED2, LED ON); 
83. } 

/* LED3 


级 各 以 旧 案 方式 按 收 漳 | 息 ， 如 果 发 现 消息 队列 FLUSH 
则 点 亮 LED3 */ 
86. state = TclReceiveMessage (&LedMo, 


#9: { 

90. EVB_LEDControl (LED2, LED OFF); 
91. } 

92; } 

5 

94 . 

95。“ /*. LED3 

线程 的 主 函数 */ 

96. static void ThreadLED3Entry (void* pArg) 
7 

6; TState state; 

99. TLEDMsg* pMsg; 

100. TErrno errno; 

gs 

102. while (eTrue) 

103. { 

104. LED3 

天桥 阳 关 方式 接 作 洒 息 ， 如 果 发 现 消息 队列 FLUSH 

则 熄灭 LED3 */ 

J09% state = TclReceiveMessage (&LedMo, 
106. IPC_OPT 





(void**) (gpMsg) 
87. IPC OPT WAIT, 0, 
88. if ((state != eSuccess) && (errno & ERR IPC FLUSH, 


eg 
"_ WAIT, 0, 


7 
&errno); 
) 


(gpMsg) 
&errno 


a07? if ((state != eSuccess) && (errno & ERR_IPC FLUSH 


108 . { 

109 EVB_LEDControl (LED3, LED ON); 
110. } 

Rd 

12 /* LED3 

站 在 以 四 襟 方式 术 人 清 i 息 ， 如 果 发 现 消息 队列 FLUSH 

则 点 亮 LED3 */ 

113 . state = TclReceiveMessage (&LedMQ， 
114. IPC OPT 


i 
WAIT, 0, 


(&PMsg) 
&errno 


hl5 if ((state != eSuccess) && (errno & ERR IPC FLUSH 
{ 


TE 


TY EVB_LEDControl (LED3, LED OFF); 


118. } 

二 } 

120%. | 

12T5 

2 

2 

主 控 线程 的 主 函 数 */ 

124. static void ThreagdCTRLENtry (void* pArg) 
T1253- 














126. TErrno errno; 
T1275 

2 while (eTrue) 
i129, { 


F903 你 


) 


) 


j 
) 


六 
) 


) 


) 





出 
和 
入 
要 
- 





入 队列 FLUSH */ 
3 TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 
二。 TclFlushMsgQueue (&LedMQ， &errno); 
T33, t 
134. } 
L353 
136. 
YA Gn 
用 户 应 用 程序 入 口 函数 */ 
138. static void APP LEDEnNtry (void) 
T39744 
140. TErrno errno; 
141. 
142 . 
配置 你 二 的 LED 
六 


143 . EVB_LEDConfig () 7 


初始 化 消息 队列 */ 
146 . TclInitMsgQueue (&LedMO, (void**) (&LedMsgPool) ， 
147. MO POOL LEN, IPC PROP NONE, &errno); 


149. /* 
初始 化 LED 
设备 控制 线程 */ 


150. TclInitThread(&ThreadLED]1, &ThreadLEDlEnNntry, (void*)NULL, 


DLs ThreadLEDlStack, THREAD LED STACK SIZE, 
152. THREAD LED PRIORITY, THREAD LED SLICE); 


154. 2 
初始 化 LED 
设备 控制 线程 */ 





TIS: TclInitThread (&ThreadLED2, &ThreadLED2EnNtry, (void*)NULL, 


156. ThreadLED2Stack, THREAD LED STACK SIZE, 
Oe THREAD LED PRIORITY, THREAD LED SLICE); 


159. a 
初始 化 LED 
设备 控制 线程 */ 


160, TclInitThread (&ThreadLED3, &ThreadLED3EnNntry, (void*)NULL, 


i ThreadLED3Stack, THREAD LED STACK SIZE, 
下 52: THREAD LED PRIORITY, THREAD LED SLICE); 


164. / 


初始 化 CTRL 
线程 */ 





ThreadCTRLStack, THREAD CTRL STACK SIZE, 
THREAD CTRL PRIORITY, THREAD CTRL SLICE); 


/* 
TclActivateThread (&ThreadLED1) 


TclActivateThread (&gThreadLED2); 
TclActivateThread (&ThreadLED3); 











a EE 
激活 主 控 线程 */ 
二 55 TclActivateThread (&ThreaqCTRIL) 
Po 让 
472 
i 
处 理 器 BOOT 
之 后 会 调用 main 
函数 ， 必 须 提供 */ 
179. int main (void) 
180. 芋 
181. fe 
注册 处 理 器 初始 化 函数 到 内 核 */ 
1 TclSetCpuEntry (&CPU_STM32F10xInit); 
183, 
184. J 
注册 板 级 初始 化 函数 到 内 核 */ 
185. TclSetBoardEntry (&EVB_SetupBoard); 
186. 
187 . 
注册 板 级 调试 打印 函数 到 内 核 */ 
188 . TclSetTraceRoutine (&EVB UartlWriteString); 
189, 
190, ie 
注册 用 户 初始 化 函数 到 内 核 */ 
ls TclSetUserEntry (&APP LEDENtry); 
了 925 
L934 a 
启动 内 核 */ 
194. TclStartKernel (); 
L903 
196 Feturn Ts 
9 
198. 
199. #engdif 








程序 运行 后 ，LED 的 变化 如 图 7-24 所 示 。 
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7-24 LED 的 变化 情况 














7.3.6 ”多 线程 同步 与 消息 队列 广播 


在 本 例 中 ， 实 现 多 个 LED 线 程 和 1 个 控制 线程 的 单 向 数据 传输 。 实 现 3 个 LED 分 别 按照 1 秒 的 间隔 点 亮 和 熄灭 。 这 里 使 用 了 1 个 消息 队列 。 














具体 实现 时 ， 多 个 LED 线 程 的 线程 函数 相似 ， 都 是 以 阻塞 方式 从 同一 消息 队列 读 取消 息 ， 目 的 是 阻塞 在 消息 队列 的 线程 阻塞 队列 上 ， 使 得 多 个 线程 的 执行 路 径 交 汇 在 一 起 。 而 控制 线程 则 是 每 隔 1 秒 对 消 
息 队 列 进行 一 次 广播 操作 ， 使 得 那些 阻塞 在 消息 队列 的 线程 阻塞 队列 上 的 线程 都 解除 阻塞 。 而 被 解除 阻塞 的 线程 则 根据 消息 内 容 点 亮 或 者 熄灭 LED。 代 码 实现 如 代码 清单 7-15 所 示 。 

















代码 清单 7-15: 消息 队列 应 用 例 程 6 


1. #include "example.h" 

2. #include "trochili.h" 

3. #include "evb bsp.h" 

4. 

5. #if (EVB EXAMPLE == CH7 MESSAGF FXAMPLE6) 
GB 

RE 

用 户 线程 参数 */ 

8. #define THREAD LED STACK SIZE (256) 
9. #define THREAD LED PRIORITY (7) 
10. #define THREAD LED SLICE (20) 
1 


12. #define THREAD CTRL STACK SIZE (256) 
13. #define THREAD CTRL PRIORITY (8) 
14. #define THREAD CTRL SLICE (20) 


hn 

用 户 线程 定义 */ 

17. static TThread ThreadLED17 
18. static TThread ThreadLED27 
19. static TThread ThreadLED3; 
20. static TThread ThreadcTRL; 


2 

用 户 线程 栈 定义 */ 

23. static TWord ThreadLED1Stack 
24. static TWord ThreadLED2Stack 
25. static TWord ThreadLED3Stack 
26. static TWord ThreadCTRLStack 
NT 

28,. J* 

用 户 消息 类 型 定义 */ 

29. typedef struct 


THREAD LED STACK SIZE]; 
THREAD LED STACK SIZE]; 
THREAD LED STACK SIZE]; 
THREAD CTRL STACK SIZE] 


30. 

Ls TWord Index; 
2 TWord Value; 
33. } TLEDMsg; 

34. 

ys J 


用 户 消息 队列 定义 */ 

36. #define MO POOL LEN (32) 

37. static TMsgQueue LedMQ” 

38. static void* LedMsgPool [MO POOL LEN]; 
9 

40, /* 

用 户 消息 定义 */ 

41. static TLEDMsg LedMsg; 

42. 

43. /* LED1 

线程 的 主 函 数 */ 

44. static void ThreadLED1Entry (void* pArg) 





45. { 

46. TState state; 

47. TLEDMsg* pMsg; 

48. TErrno errno; 

49. 

50. while (eTrue) 

51. { 

5 /* LED3 

线程 以 阻塞 方式 接收 消息 ， 按 照 消息 内 容 来 点 亮 或 者 熄灭 LED3 */ 

9s state = TclReceiveMessage (&LedMO, (void**) (gpMsg), IPC OPT WAIT, 
54. 0, &errno); 站 
55: if (state = eSuccess) 

56 . { 

57. EVB LEDControl (LED1, pMsg->Value); 

58 . } 

59: } 

60. } 

61. 


线程 的 主 函 数 */ 

63. static void ThreadLED2Entry (void* pArg) 
64. 1{ 

65. TState state; 

66. TLEDMsg* pMsg; 

SE TErrno errno; 

68 . 

69 . while (eTrue) 

70. { 





71. /* LED3 

线程 以 阻塞 方式 接收 消息 ， 按 照 消息 内 容 来 点 亮 或 者 熄灭 LED3 */ 
state = 

3 0, &errno); 
74. if (state 一 eSuccess) 

5 

E EVB_LEDControl (LED2, pMsg->Value); 
3 二 

8: b: 

A 什 

80. 

81. /* LED3 

线程 的 主 函数 */ 

82. static void ThreadLED3Entry (void* pArg) 





3 圭 

84. TState state; 
825: TLEDMsg* pMsg; 
ke， TErrno errno; 
87. 

88. while (eTrue) 
89. { 





90. /* LED3 
线程 以 阻塞 方式 接收 消息 ， 按 照 消息 内 容 来 点 亮 或 者 熄灭 LED3 */ 
91. 


TclReceiveMessage (&LedMO, (void**) (&pMsg), IPC OPT WAIT, 


state = TclReceiveMessage (&LedMO, (void**) (gpMsg), IPC OPT WAIT, 


92. 0, &errno); 
四 if (state 一 eSuccess) 

94 . 

955 EVB_LEDControl (LED3, pMsg->Value); 
96 . } 

97 . 

98. } 

99. 

100. /* , 

主 控 线程 的 主 函 数 */ 

101. static void ThreadCTRLENtry (void* pArg) 














0 4 

LO TLEDMsg* pMsg = &LedMsg; 
104. TErrno errno; 

105. 

106. while (eTrue) 

107 . 

108 . 7 






线程 延 时 1 





TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 
PMsg->Index = LEDALL; 

PMsg->Value = LED ON; 

TclBroadcastMessage (&LedMO, (TMessage*)&pMsg, &errno); 








/* 
利 后 广播 消息 ， 把 所 有 LED 

都 熄灭 */ 

3 TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 

116. PMsg->Index = LEDALL; 

TL. PMsg->Value = LED OFF; 

118:; TclBroadcastMessage (&LedMQ， (TMessage*) &pMsg, &errno); 
119, } 

i208 

Te1s 

122. 

Po 全 


用 户 应 用 入 口 函 数 */ 
124. static void APP LEDEnNtry (void) 








5 玉 

TG TErrno errno; 

了 2 

128., /* 

配置 使 能 评估 板 上 的 LED 

设备 */ 

EA EVB LEDConfig(); 

.30: 

证 5 

初始 化 消息 队列 */ 

了 2 TclInitMsgQueue (&LedMQ， (void**) (&LedMsgPool) ， 

3 MO_POOL LEN, IPC PROP NONE, &errno); 
134. 

135. A 

初始 化 LED 

设备 1 

控制 线程 */ 

L365 TclInitThread(&ThreadLED]1, &ThreadLEDlEnNntry, (void*)NULL, 
Ts ThreadLED1Stack, THREAD LED STACK SIZE, 
a THREAD LED PRIORITY, THREAD LED SLICE); 
39, 

140. Cs 

初始 化 LED 

设备 2 

控制 线程 */ 

141. TclInitThread (&ThreadLED2, &ThreadLED2EnNtry, (void*)NULL, 
142 . ThreadLED2Stack, THREAD LED STACK SIZE, 
143. THREAD LED PRIORITY, THREAD LED SLICE); 
144. 

#9 /* 

初始 化 LED 

设备 3 

控制 线程 */ 

146. TclInitThread (&ThreadLED3, &ThreadLED3EnNntry, (void*)NULL, 
147. ThreadLED3Stack, THREAD LED STACK SIZE, 
148. THREAD LED PRIORITY, THREAD LED SLICE); 
149. 

SB 

初始 化 CTRL 

线程 */ 

it TclInitThread(&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
TOR ThreadCTRLStack, THREAD CTRL STACK SIZE, 
59 THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
154. 

工 55， A 

激活 LED 

线程 */ 

156. TclActivateThread (&ThreadLED]1); 

六 TclActivateThread (&ThreadLED2); 

J TclActivateThread (&ThreadLED3); 

159, 

Men pe 

激活 主 控 线程 */ 

161. TclActivateThread (&ThreadCTRL); 

162. } 

1635 

164. /* 

处 理 器 BOOT 

之 后 会 调用 main 


函数 ， 必 须 提 供 * 

165. int main (void) 

166. { 

POT A 

注册 处 理 器 初始 化 函数 到 内 核 */ 

168 . TclSetCpuEntry (&CPU_STM32F10xInit) 7 


do 


Si 内 核 */ 
TclSetBoardEntry (&EVB_SetupBoard); 


1 

二 J/ 

泪 训 权 级 调 纯 函数 到 内 核 */ 

174. TclSetTraceRoutine (&EVB UartlWritestring); 


1 


A 
演 电 订户 初 给 化 函数 到 内 核 jh 
LF TclSetUserEntry (&APP LEDENtry); 


178. 
179 i 
局 名 内 核 */ 
本 TclStartKernel () 7 
I 
182. return 1; 
183. } 
184. 
185. #engdif 





程序 运行 后 ，LED 的 变化 如 图 7-25 所 示 。 
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7-25 LED 的 变化 情况 














7.3.7 ”线程 阻塞 解除 


在 本 例 中 ， 消 息 被 定义 为 LED 的 控制 命令 。 然 后 两 个 线程 通过 的 消息 队列 ， 发 送 和 接收 消息 ， 从 而 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 





其 中 LED 线 程 不 停 地 以 阻塞 方式 尝试 接收 消息 ， 然 后 根据 接收 结果 进行 LED 的 控制 。 如 果 是 线程 LED 被 解除 阻塞 则 点 亮 LED， 然后 再 次 尝试 接收 消息 ; 如 果 是 消息 队列 再 次 被 解除 阻塞 则 熄灭 LED。 主 控 
线程 不 停 地 按照 1 秒 的 间隔 取消 初始 化 消息 队列 ， 初 始 化 消息 队列 ， 循 环 往复 。 程 序 实 现 如 代码 清单 7-16 所 示 。 





代码 清单 7-16: 消息 队列 应 用 例 程 7 





1. #include "example.h" 

2. #include "trochili.h" 

3. #include "evb bsp.h" 

4. 

和 #if (EVB EXAMPLE 一 CH7 MESSAGF FEXRMPLE7) 
6 

了 7 

用 户 维和 参数 */ 

8. #define THREAD LED STACK SIZE (256*2) 
9. #define THREAD LED PRIORITY (7) 

10. #define THREAD LED SLICE (20) 

11 


12. #define THREAD CTRL STACK SIZE (256*2) 
13. #define THREAD CTRL PRIORITY (6 
14. #define THREAD CTRL SLICE (20) 


j 和 及 定义 */ 
17. static TThread ThreadLED; 
18. static TThread ThreadCTRL; 


20. 

和 有 栈 定义 */ 

21. static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
22. static TWord ThreadCTRLStack [THREAD CTRL : STACK _ SIZE]; 
24. /* 


25s struct 


26. { 

区 7。 TWord Index; 
28. TWord Value; 
29. } TLEDMsg; 

30 . 

1 


3 

用 户 消息 队列 定义 */ 

32. #define MO POOL LEN (32) 

33. static TMsgQueue LedMO; 

34. static void* LedMsgPoo] [MO POOL LEN]; 
35。 

36: 7 

用 户 消息 定义 */ 

37. static TLEDMsg LedMsg; 

38, 


39. /* LED 
线程 的 主 函 数 */ 
40. static void ThreadLEDEntry (void* pArg) 





41. { 

42. TState state; 
43. TLEDMsg* msg; 
44. TErrno errno; 
45. 

46. while (eTrue) 
4 


/* LED 
入 和 人 如 果 被 强制 解除 阻塞 则 点 亮 LED1 */ 


state = TclReceiveMessage (&LedMO, (void**) (gmsg), 


3: IPC OPT WAIT, 0, &errno); 
ls if ((state != eSuccess) && (errno & ERR IPC ABORT)) 
52 . { 

53. EVB_LEDControl (LED1, LED ON); 

54. } 

2 


六 式 人 机， 如 果 被 强制 解除 阻塞 则 熄灭 LED1 */ 

state = TclReceiveMessage (&LedMO, (void**) (gmsg), 
- IPC OPT WAIT, 0, &errno); 
3 if ((state != eSuccess) && (errno & ERR_IPC ABORT)) 
60. * 
61. EVB_LEDControl (LED1, LED OFF); 
62 . } 





主 控 线程 的 主 函 数 */ 
. static void ThreadCTRLENtry (void* pArg) 
{ 











TErrno errno; 
while (eTrue) 


J* 
线程 延 时 1 
秘 ， 然后 将 LED 
多 4 省 | 息 队 列 的 


给 半 队列 中 强 抽 名 % 

TclDelayThread (uThreadCurrent, MLS2TICKS (1000) ) 7 
0 TclAbortMsgQueue (&LedMO, &ThreadLED, &errno) 
78. 4 
| 
80. 
81. 


A G 
用 户 应 用 入 口 函 数 */ 
83. static void APP LEDEntry (void) 











84. { 

85 TErrno errno; 

86. 

87 . J 

配置 使 能 评估 板 上 的 LED 

设备 */ 

88. EVB LEDConfig(); 

89. 

90 . 尖 

初始 化 消息 队列 */ 

TclInitMsgQueue (&LedMO, (void**) (gLedMsgPool), 

92. MO_POOL, LEN, IPC PROP NONE, &errno); 
9 

94. 人 

初始 化 LED 

设备 控制 线程 */ 

5 TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
6 ThreadLEDStack, THREAD LED STACK SIZE, 
8 THREAD LED PRIORITY, THREAD | LED ) SLICE); 
98. 

9 

初始 化 CTRL 

线程 */ 

100. TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 


ThreadCTRLStack, THREAD CTRL STACK SIZE, 
THREAD CTRL PRIORITY, THREAD CTRL SLICE); 


TclActivateThread (&gThreadLED); 





lg pe 
EF 控 线程 */ 
TclActivateThread (&gThreadCTRL); 











SEX 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

112. int main (void) 

113; 

114. /* 

注册 处 理 器 初始 化 函数 到 内 核 */ 

115. TclSetCpuEntry (&CPU_STM32F10xInit); 
16 

LI 

注册 板 级 初始 化 函数 到 内 核 */ 

J TclSetBoardEntry (&EVB_SetupBoard); 
119, 

TD 人 

注册 板 级 调试 打印 函数 到 内 核 */ 

2 TclSetTraceRoutine (&EVB UartlWriteString); 
二 225 

2 

注册 用 户 初始 化 函数 到 内 核 */ 

124. TclSetUserEntry (&APP LEDENtry); 
129;, 

126. EE 

启动 内 核 */ 

于 TclStartKernel (); 

126% 

129. return 1; 

130. } 

Cols 

132. #endif 








程序 运行 后 ，LED 的 变化 如 图 7-26 所 示 。 
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7.3.8 ”消息 队列 取消 初始 化 


在 本 例 中 ， 消 息 被 定义 为 LED 的 控制 命令 。 两 个 线程 通过 消息 队列 发 送 和 接收 消息 ， 从 而 实现 3 个 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭。 





其 中 LED 线 程 不 停 地 以 阻塞 方式 尝试 接收 消息 ， 然 后 根据 接收 结果 进行 LED 的 控制 。 如 果 是 线程 LED 被 取消 初始 化 则 点 亮 LED， 然 后 再 次 尝试 接收 消息 ; 如 果 是 消息 队列 被 取消 初始 化 则 熄灭 LIED。 主 控 
线程 不 停 地 按照 1 秒 的 间隔 取消 初始 化 消息 队列 ， 初 始 化 消息 队列 ， 循 环 往复 。 注 意 在 这 个 例 程 里 ，LED 线 程 和 主 控 线 程 都 没有 数据 传输 。 程 序 实现 如 代码 清单 7-17 所 示 。 


代码 清单 7-17: 消息 队列 应 用 例 程 8 


1. #include "example.h" 

2. #include "trochili.h" 

3. #include "evb bsp.h" 

4. 

5. #if (EVB EXAMPLE == CH7 MESSAGF FXAMPLE8) 
6. 

A 

用 户 线程 参数 */ 

8. #define THREAD LED STACK SIZE (256) 
9. #define THREAD LED PRIORITY (7) 
10. #define THREAD LED SLICE (20) 
4 


12. #define THREAD CTRL STACK SIZE (256) 
13. #define THREAD CTRL PRIORITY (6) 
14. #define THREAD CTRL SLICE (20) 


hE 

用 户 线程 定义 */ 

17. static TThread ThreadLED17 
18. static TThread ThreadLED27 
19. static TThread ThreadLED3; 
20. static TThread ThreadcTRL; 


2 

用 户 线程 栈 定义 */ 

23. static TWord ThreadLED1Stack 
24. static TWord ThreadLED2Stack 
25. static TWord ThreadLED3Stack 
26. static TWord ThreadCTRLStack 
27. 


THREAD LED STACK SIZE]; 
THREAD LED STACK SIZE]; 
THREAD LED STACK SIZE]; 
THREAD CTRL STACK SIZE] 


28, J 
用 户 消息 类 型 定义 */ 
29. typedef struct 


30. 

ls TWord Index; 
2 TWord Value; 
33. } TLEDMsg; 

34. 

5s J 


用 户 消息 队列 定义 */ 

36. #define MO POOL LEN (32) 

37. static TMsgQueue LedMO; 

38. static void* LedMsgPool [MO POOL LEN]; 
9、 

40. /* LED1 

线程 的 主 函 数 */ 

41. static void ThreadLEDlEntry (void* pArg) 








42. { 

43. TState state; 

44. TLEDMsg* pMsg; 

45. TErrno errno; 

46. 

47. while (eTrue) 

48 . 

49 . /* LED1 

线程 以 阻塞 方式 接收 消息 ， 如 果 发 现 消息 队列 被 重 置 则 点 亮 LED1 */ 

S00 state = TclReceiveMessage (&LedMO, (void**) (gpMsg), IPC OPT WAIT, 
51. 0, &errno); < 
S52 if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 

53. { 

54. EVB LEDControl (LED1, LED ON); 

55: } i 及 

56. 

57. /* LED1 

线程 以 阻塞 方式 接收 消息 ， 如 果 发 现 消息 队列 被 重 置 则 熄灭 LED1 */ 

58 . state = TclReceiveMessage (&LedMO, (void**) (gpMsg), IPC OPT WAIT, 
59. 0, &errno); 8 
60 . if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 

61 

62. EVB_LEDControl (LED1, LED OFF); 

63. } 


65. } 

66. 

67. /* LED2 

的 线程 的 主 函数 */ 

68. static void ThreadLED2Entry (void* pArg) 








G8. .4 
70. TState state; 
Fs TLEDMsg* pMsg; 
Ts TErrno errno; 
3: 
4. while (eTrue) 
5。 3 
76. 
线程 以 虽 案 方式 食 收 并 ， 如 果 发 现 消息 队列 被 重 置 则 点 亮 LED2 */ 
Es state = TclReceiveMessage (&LedMO, (void**) (gpMsg), IPC OPT WAIT, 
78. 0, g&errno); Ee 
9. if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 
80. { 
81. EVB_LEDControl (LED2, LED ON); 
82 . } 
3， 
/* LED2 





昌江， 如 果 发 现 消息 队列 被 重 置 则 熄灭 LED2 */ 
state = TclReceiveMessage (&LedMQ， (void**) (gpMsg), IPC OPT WAIT, 
Be 0, &errno); cove 
87. if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 
88. 
89 . EVB_LEDControl (LED2, LED OFF) 7 
90 . } 
1; } 
92: 于 
935 
94. /* LED3 
线程 的 主 函数 */ 
95. static void ThreadLED3Entry (void* pArg) 




















6 二 
TState state; 
98. TLEDMsg* pMsg; 
S99: TErrno errno; 
100. 
101. while (eTrue) 
L020: { 
/* LED3 
玉生 WH 案 方 式 拷 收 滑 | 息 ， 如 果 发 现 消息 队列 被 重 置 则 点 亮 LED3 */ 
104. state = TclReceiveMessage (&LedMO, (void**) (gpMsg), IPC OPT WAIT, 
OS: 0, &errno); ot 
106. if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 
1075 { 
108 . EVB_LEDControl (LED3, LED ON) 
109, } . 
a 
/* LED3 
下 者 四 宣 方 式 本 收 基 ， 如 果 发 现 消息 队列 被 重 置 则 熄灭 LED3 */ 
ji state = TclReceiveMessage (&LedMO, (void**) (&pMsg), IPC OPT WAIT, 
中 了 涉 0, &errno); 
114. if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 
TLS { 
116. EVB LEDControl (LED3, LED OFF); 
117. } 的 
118 . 于 
J19..} 
了 205 
A 





主 控 线程 的 主 函 数 */ 
122. static void ThreagdCTRLENtry (void* pArg) 














pr 
124. TErrno errno; 
os while (eTrue) 
二 和 6 { 
127. a 
线程 延 时 1 
秒 */ 
ta TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 
T2090 
130. ji 





息 队 列 */ 
TclDeinitMsgQueue (&LedMQO， &errno) 





132. 





/* 


0 息 以 | 需要 再 次 初始 化 才能 使 用 */ 
TclInitMsgQueue (&LedMQO， (void**) (&LedMsgPool)， 
了 3 和 MO POOL LEN, IPC PROP NONE, &errno) 
136. } 
TT 
138. 
139; 
140. /* 
用 户 应 用 入 口 函 数 */ 
141. static void APP LEDEnNtry (void) 
了 J422 { 
143 . TErrno errno; 
人 





x 


冲 晤 使 能 评 个 板 上 的 TaD 
设备 */ 

146. EVB_LEDConfig () 7 

147. 

148. Fy 

初始 化 消息 i Nh 

149. TclInitMsgQueue (&LedMO, (void**) (&LedMsgPool), 

150. MO_POOL LEN, IPC PROP NONE, &errno); 
ds 

52, /* 

初始 化 LED 

设备 


1 
控制 线程 */ 
563 TclInitThread(&ThreadLED]1, &ThreadLEDlEnNntry, (void*)NULL, 
154. ThreadLEDlStack, THREAD LED STACK SIZE, 
55 THREAD LED PRIORITY, THREAD _ LED ) SLICE); 
156, 
J3rs Cs 
初始 化 LED 


设备 2 
控制 线程 */ 
eat: TclInitThread(&ThreadLED2, &ThreadLED2EnNtry, (void*)NULL, 
159., ThreadLED2Stack, THREAD LED STACK SIZE, 
160. THREAD LED PRIORITY, THREAD LED SLICE); 
161. 
162 . 
初始 化 LED 
设备 3 


控制 线程 */ 

3 TclInitThread (&ThreadLED3, &ThreadLED3EnNntry, (void*)NULL, 
164. ThreadLED3Stack, THREAD LED STACK SIZE, 
1655 THREAD LED PRIORITY, THREAD LED SLICE); 
166. 

167. A 

初始 化 CTRL 

线程 */ 

168. TclInitThread(&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
169. ThreadCTRLStack, THREAD CTRL STACK SIZE, 
70. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
le 

1 A 

激活 LED 

线程 */ 

证 3 TclActivateThread (&ThreadqLED1) 

174. TclActivateThread (&ThreadLED2); 

TID TclActivateThread (&ThreadLED3); 


/* 
E 控 线程 */ 
TclActivateThread (&ThreadCTRL); 





之 后 会 调用 main 
函数 ， 必 须 提供 */ 
. int main (void) 
-1{ 
4. iy 
处 理 器 初始 化 函数 到 内 核 */ 
TclSetCpuEntry (&CPU_STM32F10xInit); 


4 hy 
板 级 初始 化 函数 到 内 核 */ 








188 TclSetBoardEntry (&EVB_ SetupBoard) 7 
189 . 

T90。 oe 

注册 板 级 调试 打印 函数 到 内 核 */ 

191. TclSetTraceRoutine (&EVB UartlWriteString); 
92 

TY Py 

注册 用 户 初始 化 函数 到 内 核 */ 

194 TclSetUserEntry (&APP LEDENtry); 
195。 加 

6s 

启动 内 核 */ 

197, TclStartKernel (); 

198. 

199, return 1; 

200. } 

201. 

202. #endif 








图 


程序 运行 后 ，LED 的 变化 如 








7-27 所 示 。 
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事件 标记 是 RTOS 提 供 的 用 于 任务 间或 者 任务 与 ISR 间 的 同步 机 制 ， 和 前 面 介绍 的 几 种 同步 机 制 相 比 ， 它 最 大 的 优点 是 可 以 用 于 任务 同时 等 待 多 个 事件 的 目的 。 本 章 详细 


计 与 实现 。 


8.1 事件 标记 基础 知识 
8.1.1 事件 标记 的 概念 

事件 标记 是 用 来 表示 某 些 事件 已 经 发 生 的 机 制 。 一 些 任 务 可 以 关注 、 
一 个 事件 集 ,或 者 称 为 事件 组 。 事 件 集 一 般 以 处 理 器 字 长 为 自 


的 。 
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第 8 章 ”事件 标记 设计 实现 








省 待 某 些 寻 
































有 件 的 发 生 ， 而 另外 一 些 任务 或 者 ISR 可 以 发 送 这 些 续 





有 位 ， 比 如 在 32 位 的 处 理 器 上 就 倾向 选择 1 个 32 位 的 变量 ， 来 代表 和 保存 各 个 事件 。 








在 对 








和 件 集中 ， 各 个 


任务 关注 的 





任务 阻塞 队列 





件 是 独立 的 ， 也 就 是 “位 或 ”关系 ， 任 务 可 以 同时 等 待 或 者 发 送 一 个 或 者 几 个 寻 


件 集合 ， 可 以 是 “发 生 ”， 也 可 以 是 “ 没 发 生 ”， 即 : 如 果 某 些 位 被 设置 了 则 去 做 些 什么 导 











件 。 


























有 件 通知 正在 等 待 的 任务 。 一 个 导 





， 或 者 如 果 某 些 位 没有 设置 则 去 做 些 什么 事 。 


介绍 


介绍 


事件 标记 的 概念 、 用 途 、 设 





件 就 是 一 位 标记 ， 多 个 事件 标记 组 成 





为 ISR 不 能 被 阻塞 ， 所 以 它 不 能 接收 事件 ， 而 只 能 是 事件 的 生产 者 。 





这 个 功能 的 取舍 需要 看 操作 系统 具体 是 如 何 实现 


















































件 标记 具有 任务 阻塞 的 能 力 ， 需 要 一 个 任务 阻塞 队列 





于 保存 那些 等 待 某 些 导 





件 发 生 的 任务 。 在 发 送 导 








8-1 是 一 个 基本 的 











有 件 标记 的 模型 。 





有 件 时 任务 不 会 被 阻塞 。 





在 图 











8-1 中 ， 任 务 A 等 待 事件 5 和 









































任务 B 等 待 事件 29 和 本 





任务 C 等 待 事件 28、 事 件 4 和 事件 5， 事 件 关系 是 AND， 这 三 个 寻 


31 


件 30,， 习 





0 事件 27， 事 件 关系 是 OR， 这 两 个 事件 中 的 任 


ps 


生 则 任务 A 被 唤醒 。 








件 关系 是 AND， 这 两 个 事件 必须 同时 发 生 则 任务 B 被 唤醒 。 

















30 


9 | 


件 必须 同时 发 生 则 任务 C 被 唤醒 。 











8.1 事件 标记 基础 知识 
8.1.1 事件 标记 的 概念 
事件 标记 是 用 来 表示 某 些 寻 



































一 个 事件 集 ， 或 者 称 为 村 








件 已 经 发 生 的 机 制 。 一 些 任务 可 以 关注 、 


件 组 。 事 件 集 一 般 以 处 理 器 字 长 为 身 


图 8-1 


事件 标记 














位 ， 比 如 在 32 位 的 处 理 器 上 就 倾向 选择 1 个 32 位 的 变量 ， 











在 事件 集中 ， 各 个 事件 是 独立 的 ， 也 就 是 “位 或 ”关系 ,任务 可 以 同时 等 待 或 者 发 送 一 个 或 者 几 个 








任务 关注 的 事件 集合 ,可 以 是 “发 生 ”， 也 可 以 是 “ 没 发 生 ”， 即 : 如 果 某 些 位 被 设置 了 则 去 做 些 什么 


的 。 


任务 阻塞 队列 

















件 标记 








在 图 











有 任务 阻塞 的 能 











件 。 








秆 待 某 些 事件 的 发 生 ， 而 另外 一 些 任务 或 者 ISR 可 以 发 送 这 些 导 





有 件 通知 正在 等 待 的 任务 。 一 个 导 





件 就 是 一 位 标记 ， 多 个 寻 





有 件 标记 组 成 





来 代表 和 保存 各 个 事件 。 


为 1SR 不 能 被 阻塞 ， 所 以 它 不 能 接收 事件 ， 而 





























， 或 者 如 果 某 些 位 没有 设置 则 去 做 些 什么 导 





只 能 是 事件 的 生产 者 。 




















， 需 要 一 个 任务 阻塞 队列 











于 保存 那些 等 待 某 些 导 











件 发 生 的 任务 。 在 发 送 事 件 时 任务 不 会 被 阻塞 。 

















8-1 是 一 个 基本 的 事件 标记 的 模型 。 

















8-1 中 ， 任 务 A 等 待 事件 5 和 事件 27， 事 件 关系 是 OR.， 
































任务 B 等 待 事件 29 和 村 





件 30,， 习 








任务 C 等 待 事件 28、 事 件 4 和 事件 5， 事 件 关系 是 AND， 这 三 个 寻 








这 两 个 事件 中 的 任意 一 个 发 生 则 任务 A 被 唤醒 。 


件 关系 是 AND， 这 两 个 事件 必须 同时 发 生 则 任务 B 被 唤醒 。 

















件 必须 同时 发 生 则 任务 C 被 唤醒 。 


有 。 这 个 功能 的 取舍 需要 看 操作 系统 具体 是 如 何 实现 





3 SO 0 2 | ess a A ES 2 | | 





8.1.2 事件 标记 的 操作 











常见 的 事件 标记 的 应 用 如 表 8-1 所 示 。 











create 
delete 
recelve 
send 
fush 


qUeIY 


表 8-1 事件 标记 功能 


功能 
事件 标记 创建 
事件 标记 删除 
从 事件 标记 中 接收 事件 
问 事 件 标记 发 送 事件 
事件 标记 任务 阻塞 队列 的 刷新 
事件 标记 查询 


“ Create 创建 事件 标记 : 创建 事件 标记 时 ， 用 户 可 以 指定 事件 标记 的 各 种 参数 属性 。 比 如 针对 多 个 任务 在 事件 标记 上 的 阻塞 和 调度 方式 : 既 可 以 配置 成 先进 先 出 的 FIFO 方 式 来 处 理 ， 也 可 以 按照 任务 优 


先 级 来 处 理 。 


“ Delete 删 除 事件 标记 : 删除 事件 标记 时 ， 需 要 把 所 有 阻塞 在 事件 标记 上 的 任务 解除 阻塞 ， 事件 标记 一 旦 被 删除 ， 就 不 能 再 次 操作 了 。 


“ Receive 接 收 事 件 : 如 果 事 件 标 记 的 当前 事件 为 0， 即 没有 任何 事件 发 生 ， 则 任务 要 么 直接 返回 ， 要 么 阻塞 在 事件 标记 的 任务 阻塞 队列 中 ; 否则 任务 首先 尝试 检查 自己 所 需 的 事件 是 否 发 生 ， 如 果 有 则 返 
回 成 功 ; 如 果 没 有 则 当前 任务 直接 返回 或 者 阻塞 在 事件 标记 的 任务 阻塞 队列 中 。 


: Send 发 送 事件 : 任务 或 者 ISR 首 先 将 事件 增加 到 事件 标记 中 ， 然 后 检查 是 否 有 任务 因 无 法 获得 事件 而 被 阻塞 ， 如 果 没 有 则 直接 返回 ; 如 果 有 则 会 逐个 检查 这 些 任务 ， 如 果 当 前 事件 标记 集合 满足 某 个 任 
务 ， 则 将 该 任务 唤醒 ， 解 除 阻 塞 。 发 送 事件 不 会 导致 任务 阻塞 。 因 为 一 次 发 送 可 以 唤醒 很 多 任务 ， 所 以 事件 标记 是 很 容易 实现 多 任务 同步 的 。 


“ Flush 清 空 任务 阻塞 队列 : 当 有 多 个 任务 因为 不 能 成 功 接收 事件 而 阻塞 在 事件 标记 时 ， 可 以 通过 Flush 操 作 将 这 些 任务 解除 阻塞 ， 完 成 多 任务 的 同步 。 


8.1.3 ”事件 标记 的 典型 应 用 














事件 标记 在 实际 使 




















2 所 示 : 





中 , 主 








Task/ISR 


S| AE So | 


于 任务 的 同步 ， 它 的 优点 是 任务 可 以 同时 等 待 多 个 对 





件 的 发 生 。 这 种 模式 下 ， 一 个 任务 用 来 从 


























件 标记 接收 导 








SEND/ 
4 events 











件 ， 另 外 一 个 任务 或 者 ISR 向 事件 标记 中 发 送 事 件 。 如 图 8- 











图 8-2 事件 


同步 




















在 这 种 模式 下 ， 系 统 的 行为 和 两 个 任务 的 优先 级 是 密切 相关 的 ISR 的 优先 级 必然 高 于 任务 的 优先 级 ) 。 这 里 假设 发 送 任务 发 送 的 事件 标记 肯定 满足 接收 任务 需要 的 事件 标记 。 


“ 发 送 事 件 标 记 的 任务 不 会 因 无 法 发 送 而 阻塞 ， 所 以 如 果 发 送 任务 优先 级 高 、 并 且 它 一 直 发 送 事 件 标 记 的 话 ， 那 么 因为 优先 级 抢占 原因 ， 事 件 标 记 接 收 任务 永远 无 法 运行 。 所 以 此 时 发 送 任务 必须 按照 
某 种 方式 释放 处 理 器 给 低 优 先 级 的 事件 标记 接收 任务 ， 否 则 无 法 完成 任务 间 的 通信 和 保证 系统 执行 路 径 的 正确 。 


“ 假如 发 送 任务 的 优先 级 低 于 接收 任务 的 优先 级 ， 那 么 接收 任务 首先 执行 ， 因 为 事件 标记 开始 时 是 空 的 ， 所 以 接收 任务 立刻 阻塞 在 事件 标记 的 任务 阻塞 队列 上 。 随 后 发 送 任务 得 到 处 理 器 并 发 送 一 个 事 
件 到 事件 标记 中 ， 因 为 此 时 事件 标记 为 空 并 且 有 任务 阻塞 在 任务 阻塞 队列 中 等 待 接收 事件 ， 所 以 内 核 会 把 发 送 的 事件 直接 发 给 接收 任务 。 因 为 优先 级 抢占 ， 接 收 任务 立刻 抢占 执行 。 因 为 事件 标记 此 时 保持 
空 的 状态 ， 所 以 接收 任务 会 因 再 次 接收 事件 而 再 次 阻塞 。 而 此 后 发 送 任务 再 次 运行 ， 再 次 尝试 发 送 一 个 事 人 





+ 到 事件 标记 ， 接 收 任务 也 再 次 被 唤醒 。 




















1SR 通 常 使 用 第 1 种 方式 ， 因 























为 1SR 是 要 抢占 任何 任务 来 执行 的 。 另 外 ，1SR 必 须 使 


这 种 模式 的 伪 代 码 如 下 所 示 : 











非 阻塞 方 式 来 发 送 导 


件 ， 而 且 可 以 确定 的 是 ， 





件 一 定 会 发 送 成 功 。 





1. void TaskSender (void) 

艺 。 

3 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPSVText/ . 
4. Send Flags; 

5 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 
6。 站 

了 

8. void TaskReceiver (void) 

9. { 

TO: http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/. 
he Receive Flags; 

12。 http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/14878/OEBPSVText/ . 


13. 1} 


.http://www.hzcourse. 


.http://www.hzcourse. 


.http://www.hzcourse. 


.http://www.hzcourse. 


com/resource/readBook?path=/openresources/t 


com/resource/readBook?path=/openresources/t 


com/resource/readBook?path=/openresources/t 


com/resource/readBook?path=/openresources/t 





8.2 ”事件 标记 功能 设计 





在 前 面 我 们 详细 介绍 了 事件 标记 的 概念 ， 本 节 我 们 来 分 析 在 Trochili RTOS 中 是 如 何 设 计 实 现 事 件 标 记 的 功能 的 。 











事件 标记 的 结构 定义 在 文件 flags.h 中 ， 具 体 结构 定义 如 下 : 





1, J 
事件 标记 结构 定义 */ 
2。 struct FlagsDef 


3 . { 
TProperty Property; /* 
风光 度 信 中叶 全 全 是 oy 
BitMask Value; 
i 当前 于 人 
IpcQueue Queue; /* 


Shiai 理光 本 


4 LE Struct FlagsDef TFlags; 





“ Property 事 件 标 记 属 性 : 包括 事件 标记 是 否 被 初始 化 、 线 程 阻塞 队列 的 调度 策略 等 。 
“ Value 事 件 标 记 中 的 当前 事件 : 事件 标记 用 来 保存 事件 的 成 员 变 量 ， 是 一 个 32 位 的 数据 ; 当 其 数值 为 0 说 明 无 事件 发 生 。 


"Queue 事件 标记 的 线程 阻塞 队列 : 内 核 只 使 用 了 该 队列 中 的 线程 基本 阻塞 队列 用 来 保存 那些 因为 不 能 得 到 事件 而 被 阻塞 的 线程 。 





Trochili RTOS 支 持 的 事件 标记 的 功能 主要 有 下 面 几 种 : 





“ 事件 标记 初始 化 (Init) : 初始 化 一 个 已 存在 的 事件 标记 ， 不 管事 件 标 记 结 构 是 由 动态 内 存 分 配 而 来 还 是 一 个 全 局 变量 。 事 件 标记 初始 化 之 后 才 可 以 进行 其 他 操作 。 当 前 版 本 不 支持 事件 标记 的 动态 创 
建 和 删除 。 


“ 取消 事件 标记 初始 化 (Deinit) : 将 事件 标记 恢复 到 初始 状态 ， 和 事件 标记 初始 化 的 功能 是 相反 的 。 事 件 标 记 被 取消 初始 化 之 后 ， 如 果 还 想 使 用 它 ， 则 需要 再 次 初始 化 。 

“ 发 送 事 件 (Send) : 线程 或 者 ISR 将 事件 发 送 到 事件 标记 中 。 这 个 操作 不 会 造成 发 送 事 件 的 线程 阻塞 在 事件 标记 的 线程 阻塞 队列 中 ,但 可 能 会 解除 那些 因 无 法 接收 到 事件 标记 而 被 阻塞 的 线程 。 
“ 接收 事件 (Receive) : 线程 从 事件 标记 中 接收 事件 。 有 可 能 造成 发 送 事 件 的 线程 阻塞 在 事件 标记 的 线程 阻塞 队列 中 。 

“ 取消 线程 阻塞 (Abort) : 将 事件 标记 的 线程 阻塞 队列 中 的 一 个 线程 唤醒 ， 使 得 它 不 再 等 待 事件 的 发 生 。 可 以 将 无 限 阻塞 的 线程 或 者 时 限 等 待 的 线程 提前 唤醒 。 

“ 清空 线程 阻塞 队列 (Flush) : 将 事件 标记 线程 阻塞 队列 中 的 所 有 线程 都 解除 阻塞 。 


表 8-2 事件 标记 功能 函数 


EE RE ET 





TclAbortFlags 支持 
Tho legs 加 


8.2.1 事件 标记 的 初始 化 














调用 事件 标记 初始 化 函数 比较 简单 ， 这 里 不 做 流程 分 析 。 该 函数 的 主要 步骤 如 下 : 




















1) 设置 事件 标记 属性 为 就 绪 。 























2) 设置 事件 标记 内 事件 为 空 。 

















3) 初始 化 事件 标记 线程 阻塞 队列 。 





8.2.2 ”事件 标记 的 重 置 





























事件 标记 重 置 和 





事件 标记 初始 化 是 相反 的 操作 。 它 会 对 事件 标记 做 如 下 操作 : 











巧 











“ 重新 设置 事件 标记 为 非 初始 化 状态 


“ 清空 事件 标记 的 线程 阻塞 队列 


' 设置 事件 标记 内 事件 为 空 


“ 如 果 必 要 还 会 进行 线程 调度 




















事件 标记 重 置 函数 的 流程 图 如 图 8-3 所 示 : 
































要 = 


1 天 如 


4 清除 事件 ， 设 置 事件 
标记 属性 为 未 初始 化 











图 8-3 ”事件 标记 重 置 流程 














流程 图 分 析 : 











STEP2 内核 进入 临界 区 。 

STEP3 首先 将 事件 标记 的 线程 阻塞 队列 清空 ， 唤 醒 全 部 被 阻塞 的 线程 。 

STEP4 ”清空 事件 ， 取 消 事件 标记 的 就 绪 属 性 。 

STEP5 检查 在 清空 事件 标记 的 线程 阻塞 队列 时 是 否 唤醒 了 比 当前 线程 优先 级 高 的 线程 。 


STEP6 如 果 是 ， 则 判断 内 核 是 否 允 许 线程 调度 。 





STEP7 如 果 是 ， 则 判断 该 函数 是 否 被 线程 调用 。 
STEP8 如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 
STEP9 内核 退出 独占 区 。 如 果 处 于 线程 环境 下 ， 退 出 后 可 能 发 生 线程 调度 ; 如 果 处 于 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP10 函数 返回 。 


8.2.3 接收 事件 


从 事件 标记 中 接收 事件 的 操作 主要 由 以 下 几 个 函数 来 完成 的 。 


“ 事件 标记 接收 接口 函数 xFlagsReceive () : 该 函数 是 事件 标记 模块 向 外 提供 的 接口 函数 ， 被 内 核 API 函 数 调 用 。 它 根据 操作 模式 这 个 参数 来 区 分 处 理 本 次 事件 标记 的 接收 操作 。 根 据 操 作 模 式 的 不 同 
操作 可 以 分 为 线程 模式 和 ISR 模 式 ， 还 可 以 进一步 细 分 为 线程 阻塞 方式 (无 限期 和 时 限 ) 、 线 程 立刻 返回 和 ISR 3 种 模式 。 另 外 由 该 函数 完成 和 事件 标记 相关 的 内 核 数 据 的 保护 工作 。 


“ 线程 接收 事件 标记 函数 ReceiveFlags () : 该 函数 实现 了 线程 接收 事件 标记 的 核心 逻辑 。 它 会 首先 会 检查 事件 标记 中 的 当前 事件 是 不 是 满足 需要 ， 如 果 是 则 接收 事件 ; 如 果 不 是 则 判断 线程 是 否 需要 阻 
塞 。 因 为 不 会 有 任务 因为 无 法 发 送 事件 而 阻塞 ， 所 以 事件 接收 函数 的 逻辑 比较 简单 。 


“ Istr 接 收 事件 标记 函数 IstReceiveFlags () : 该 函数 实现 了 中 断 处 理 程序 接收 事件 标记 的 功能 。 因 为 Ist 自 身 不 会 阻塞 ， 同 时 事件 标记 中 也 不 会 有 任务 因为 无 法 发 送 事 件 而 阻塞 ， 所 以 该 函数 只 需要 处 理事 
件 标 记 而 不 考虑 线程 阻塞 的 问题 。 


“ 尝试 接收 事件 标记 函数 TryReceiveFlags () : 这 个 函数 是 接收 事件 标记 的 核心 部 分 ， 它 会 判断 接收 需求 和 当前 已 有 事件 标记 来 处 理 本 次 请 求 ， 步 又 如 下 : 


1) 首先 计算 当前 已 有 事件 标记 和 需求 的 合集 ， 即 AND 操 作 。 





2) 如 果 需 求 是 OR 关 系 并 且 计算 出 的 合集 非 空 ， 则 此 次 操作 成 功 。 
3) 如 果 需 求 是 AND 关 系 并 且 计算 出 的 合集 与 需求 相同 ， 则 此 次 操作 成 功 。 


4) 如 果 成 功 则 继续 处 理 是 否 需要 将 当前 事件 集合 中 被 读 取 的 事件 消耗 掉 。 





注意 xFlagsReceive () 起 到 的 是 分 发 调用 的 作用 ， 函 数 ReceiveEvent () 是 线程 环境 下 的 具体 操作 函数 。 函 数 lsrReceiveFlags () 是 线程 环境 下 的 具体 操作 函数 。 函 数 lsrReceiveFlags () 则 只 关心 
事件 标记 本 身 的 读 取 操 作 。 


1. 接收 事件 接口 函数 


接收 事件 接口 函数 流程 图 如 图 8-4 所 示 。 


1 开始 









3 ISR 收 事件 ? 和 
是 


4 ISR 接收 事件 5 线程 接收 事件 





7 限 数 返回 


图 8-4 接收 事件 接口 函数 流程 图 
流程 图 分 析 : 
STEP3 判断 是 不 是 ISR 来 接收 事件 。 
STEP4 如 果 是 ， 则 调用 ISR 接 收 事件 函数 。 
STEP5 如 果 不 是 ， 则 调用 线程 接收 事件 函数 。 
STEP7 函数 返回 。 


从 图 8-4 可 以 看 出 ， 这 个 函数 是 个 接口 函数 ， 会 根据 操作 类 型 判断 下 一 步 该 怎么 执行 。 





2. 线程 接收 事件 函数 








[| 
线程 阻塞 阶段 
Y 


10 接收 取 事 件 


集 操作 结果 清除 事 
件 集 操作 信息 





图 8-5 ”线程 接收 事件 函数 流程 图 
流程 图 分 析 : 
STEP2 ”当前 线程 尝试 接收 事件 。 
STEP3 判断 本 次 接收 事件 操作 是 否 成 功 ， 如 果 是 则 直接 返回 。 
STEP4 如 果 没 有 成 功 ， 则 需要 检查 本 次 操作 是 不 是 阻塞 模式 。 如 果 不 是 则 直接 返回 。 
STEP5 如 果 是 ， 则 判断 内 核 是 否 关闭 了 线程 调度 。 
STEP6 如 果 是 ， 则 此 时 需要 保存 本 次 操作 的 信息 到 线程 相关 结构 ， 并 将 自己 阻塞 在 事件 标记 的 线程 阻塞 队列 中 。 
STEP7 向 内 核发 出 线程 调度 请 求 。 
STEP8 内 核 退 出 独占 区 ， 因 为 是 在 线程 环境 下 ， 退 出 后 极 有 可 能 发 生 线程 调度 ， 除 非 此 时 有 ISR 及 时 发 生 并 且 发 送 了 事件 ; 如 果 发 生 了 调度 ， 当 前 线程 被 阻塞 ， 直 到 被 再 次 唤醒 。 
STEP9 线程 被 唤醒 并 且 调度 执行 ， 在 这 里 立刻 使 得 内 核 进入 独占 区 。 
STEP10 读 取 本 次 接收 事件 操作 的 结果 ， 随 后 清空 当前 线程 的 [PC 缓存 信息 。 
STEP11 函数 返回 。 


从 上 面 的 流程 中 可 以 看 出 ， 在 线程 接收 事件 的 获取 时 ， 首 先是 检查 事件 标记 中 的 事件 是 否 满足 当前 线程 需要 。 然 后 再 根据 结果 进行 以 下 操作 : 失败 了 可 能 需要 把 自己 阻塞 ; 成 功 了 就 返回 。 这 段 代 码 的 
核心 逻辑 就 在 这 里 。 





该 函数 的 类 C 伪 代码 如 下 : 





a 
线程 接收 事件 标记 
蔚 。 { 





3. 
尝试 接收 事件 标记 
4 if 


< ( 
不 成 功 ) 
3 





6. if (( 

Et。 
( 

内 核 没 有 关闭 线程 调度 ) ) 


保存 线程 TPC 
蛆 训 信 息 


当前 线程 阻塞 在 该 事件 标记 的 阻塞 队列 ， 
当前 线程 申请 调度 ; 


打开 系统 中 断 ; 
12. 从 


此 时 此 处 非常 有 可 能 发 生 一 次 调度 ， 
除非 线程 调度 请 求 被 内 核 取消 ; 

14. 

当 处 理 器 再 次 处 理 本 线程 时 ， 
人 续 运行 . 


青 次 关闭 系统 中 断 ; 
得 对 事件 标记 进行 操作 的 结果 ; 























3， 尝试 接收 事件 标记 函数 


尝试 接收 事件 标记 函数 流程 图 如 图 8-6 所 示 。 





6 从 当前 事件 标记 中 
删除 这 些 航 该 取 的 事件 








图 8-6 ”尝试 接收 事件 标记 泡 数 流程 











流程 图 分 析 : 

STEP2 计算 出 当前 事件 标记 中 满足 条 件 的 事件 集合 。 

STEP3 判断 本 次 接收 事件 操作 能 否 成 功 ， 如 果 不 能 则 直接 返回 。 
STEP4 如 果 能 ， 则 把 成 功 读 取 的 事件 写 回 给 调用 者 。 

STEP5 判断 是 否 需要 在 事件 标记 中 保留 被 成 功 读 取 的 事件 集合 。 
STEP6 如 果 不 是 ， 则 在 事件 标记 中 删除 这 些 事件 。 


STEP7 函数 返回 。 


8.2.4 发 送 事件 


事件 的 发 送 操作 主要 是 由 下 面 几 个 函数 来 完成 的 。 











“ 发 送 事件 标记 接口 函数 xFlagsSend () : 该 函数 是 事件 标记 模块 向 外 提供 的 接口 函数 ， 被 内 核 API 函 数 调 用 。 该 操作 不 会 导致 线程 或 者 ISR 被 阻塞 ， 所 以 只 需要 指明 需要 向 哪个 事件 标记 发 送 什么 事件 标 


记 就 行 了 ， 不 需要 区 分 操作 模式 (线程 阻塞 、 线 程 立刻 返回 、ISR 立 刻 返 回 等 ) 。 


“ 发 送 事 件 函 数 SendFlags () : 该 函数 实现 发 送 事 件 标记 的 核心 逻辑 。 它 首先 调用 函数 TrySendFlags() ， 然 后 根据 结果 来 继续 操作 。 后 继 操作 只 包括 成 功 后 的 线程 调度 检查 ， 即 使 是 线程 发 送 事件 标记 
失败 也 不 需要 阻塞 线程。 


“ 尝试 发 送 事 件 函 数 TrySendFlags () : 该 函数 完成 向 事件 标记 中 发 送 事 件 。 





这 几 个 函数 的 层次 关系 比较 简单 。 接 下 来 详细 介绍 它们 的 流程 。 


1. 发 送 事件 标记 接口 函数 











该 函数 较 其 他 几 种 线程 间 同 步 机制 相 比 非常 简单 ， 没 有 操作 模式 的 区 别 。 这 里 就 不 做 流程 图 分 析 了 。 

















2. 发 送 事件 接口 函数 











发 送 事件 标记 接口 函数 流程 





网 


如 图 8-7 所 示 。 





















2 发 送 事件 标记 


3 成 功 发 送 事件 标记 ? 







4 有 比 当前 线程 优先 弘 
高 的 线程 解除 阻塞 ? 


y 


8 返回 








图 8-7 ”发 送 事件 接口 函数 流程 图 














流程 图 分 析 : 











STEP2 发 送 事件 到 事件 标记 。 


STEP3 判断 本 次 发 送 事件 操作 是 否 成 功 。 


STEP4 如 果 是 ， 则 检查 在 发 送 事件 的 时 候 ， 是 否 唤醒 了 比 当前 线程 优先 级 更 高 的 线程 。 


STEP5 如 果 是 ， 则 判断 此 时 函数 是 否 被 线程 调用 。 


STEP6 如 果 是 ， 则 判断 内 核 是 否 允 许 线程 调度 。 





STEP7 如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 


STEP8 函数 返回 。 


3. 尝试 发 送 事件 函数 





尝试 发 送 事件 函数 流程 图 如 图 8-8 所 示 。 























流程 图 分 析 : 











STEP2 当前 线程 发 送 事件 到 事件 标记 ， 判 断 是 否 有 新 的 事件 加 入 。 


STEP3 检查 事件 标记 中 是 否 有 等 待 读 取 事件 的 线程 被 阻塞 ， 如 果 有 ， 则 开始 遍历 这 些 被 阻塞 的 线程 。 





3 事件 集中 有 
程 被 阻 赛 ? 






4 从 阻 窗 队 列 中 获取 一 个 线程 


5 当前 事件 组 合 









6 唤醒 该 线程 ; 





更 新 其 等 待 结果 


TE 
= | 


7 被 接收 的 事件 


需要 保留? 





LU 








9 事件 集中 还 有 
事件 仓 在 ? 












10 还 有 其 他 线 
程 被 阻塞? 

















STEP4 ”从 线程 阻塞 队列 中 获取 一 个 线程 。 

STEP5 检查 当前 事件 是 否 满 足 该 线程 的 需要 。 

STEP6 如 果 是 唤醒 该 线程 ， 更 新 它 的 事件 接收 结果 。 
STEP7 判断 被 接收 的 事件 是 否 需要 继续 保存 在 事件 标记 中 。 
STEP8 此 时 不 需要 则 删除 这 些 事件 。 

STEP9 检查 事件 标记 中 是 否 还 有 可 用 事件 存在 。 

STEP10 检查 事件 标记 中 是 否 有 等 待 读 取 事 件 的 线程 被 阻塞 。 
STEP11 函数 返回 。 


从 上 面 的 流程 中 可 以 看 出 ， 在 获取 线程 发 送 事件 时 ， 首 先是 把 事件 更 新 到 事件 标记 中 。 如 果 有 新 的 事件 ， 则 继续 检查 是 否 有 线程 在 等 待 事件 。 如 果 有 ， 则 需要 遍历 全 部 阻塞 的 线程 ， 直 到 事件 标记 中 不 
再 有 事件 或 者 所 有 线程 遍历 完毕 。 


该 函数 的 类 C 伪 代码 如 下 : 





向 事件 标记 中 发 送 事件 
{ 














2 

3 

把 事件 发 送 到 事件 标记 中 ; 
4. 克 
有 新 事件 ) 


on 


if ( 
件 标记 中 有 线程 在 等 竺 事件 的 发 生 ) 
{ 


4 











oo ~ 


遍历 事件 组 等 待 队 列 ; 
9。 

10., 

得 到 一 个 线程: 


if ( 
事件 满足 这 个 线程 ) 
2 








更 新 该 线程 事件 结果 


1 
得 除 泛 旦 附件 











8.2.5 ”终止 线程 阻塞 


线程 阻塞 在 事件 标记 的 线程 阻塞 队列 时 ， 可 以 是 无 限期 的 阻塞 直到 等 待 的 事件 发 生 ; 或 者 有 期 限 的 等 待 ， 在 期 限 到 达 时 如 果 仍 然 无 法 成 功 则 自动 退出 阻塞 。 这 里 的 终止 事件 标记 阻塞 线程 的 操作 则 是 由 
外 部 强制 线程 解除 阻塞 ， 提 供 了 另 一 种 方式 结束 线程 对 事件 标记 的 等 待 。 解 除 线程 阻塞 函数 的 流程 图 如 图 8-9 所 示 。 




















图 8-9 ”解除 线程 阻塞 函数 流程 图 


流程 图 分 析 : 


STEP2 ”内核 进入 临界 区 。 


STEP3 将 线程 从 事件 标记 的 线程 阻塞 队列 中 解除 阻塞 。 该 函数 会 检查 指定 的 线程 是 否 阻 塞 在 事件 标记 的 线程 阻塞 队列 中 。 
STEP4 判断 被 解除 阻塞 的 线程 的 优先 级 是 否 比 当前 线程 的 优先 级 高 。 

STEP5 判断 函数 此 时 是 否 被 线程 调用 。 

STEP6 判断 内 核 此 时 是 否 关闭 了 线程 调度 。 

STEP7 向 内 核发 出 线程 调度 请 求 。 

STEP8 内 核 退 出 独占 区 。 


STEP9 函数 返回 。 


8.2.6 ”事件 标记 刷新 





事件 标记 刷新 会 将 事件 标记 线程 阻塞 队列 上 的 线程 全 部 唤醒 ， 并 且 随 后 删除 所 有 事件 ， 其 流程 图 如 图 8-10 所 示 。 这 样 的 事件 标记 就 像 刚 被 初始 化 后 的 情形 ， 可 以 继续 使 用 。 

















图 8-10 ”事件 标记 刷新 函数 流程 图 


流程 图 分 析 : 

STEP2 内核 进入 临界 区 。 

STEP3 事件 标记 的 线程 阻塞 队列 清空 ， 唤 醒 全 部 被 阻塞 的 线程 。 保 持 事件 标记 的 就 绪 属 性 。 

STEP4 检查 在 清空 事件 标记 的 线程 阻塞 队列 时 是 否 唤醒 了 比 当前 线程 优先 级 高 的 线程 。 

STEP5 如 果 是 ， 则 判断 内 核 是 否 允 许 线程 调度 。 

STEP6 如 果 是 ， 则 判断 该 函数 是 否 被 线程 调用 。 

STEP7 如 果 是 ， 则 向 内 核发 出 线程 调度 请 求 。 

STEP8 内 核 退 出 独占 区 ， 如 有 果 处 于 线程 环境 下 ， 退 出 后 可 能 发 生 线程 调度 ; 如 果 处 于 ISR 中 ， 则 内 核 不 处 理 任务 调度 事务 。 


STEP9 函数 返回 。 


8.3 ”事件 标记 应 用 演示 


下 面 结合 实例 介绍 一 些 事件 标记 常见 的 典型 用 法 。 


8.3.1 线程 间 的 同步 


在 本 例 中 ， 事 件 被 定义 为 LED 的 控制 命令 。 然 后 三 个 线程 通过 事件 标记 发 送 和 接收 事件 ， 从 而 实现 LED 按 照 既 定 的 顺序 点 亮 和 熄灭 。 其 中 主 控 线 程 按照 自己 的 节奏 按 顺序 发 送 各 种 事件 ， 每 次 发 送 事件 成 
功 后 延 时 1 秒 ; 而 两 个 LED 线 程 则 在 等 待 接收 自己 期 待 的 事件 ， 然 后 通过 接收 到 的 事件 内 容 来 控制 LED 的 点 亮 或 者 熄灭 。 

















在 这 个 例 程 里 ，LED 线 程 和 主 控 线程 的 控制 方向 是 单 向 的 ， 并 且 是 异步 的 。 即 主 控 线程 的 运行 不 依赖 LED 线 程 ; 而 另外 两 个 LED 线 程 的 执行 则 依赖 于 主 控 线 程 发 送 的 事件 。 程 序 实现 如 代码 清单 8-1 所 


代码 清单 : 8-1 





1. #include "example.h" 
2. #include "trochili.h" 


#if (EVB EXAMPLE == CH8_FLAGS EXAMPLE1) 


a 
户 线程 参数 */ 


这 #define THREAD LED STACK SIZE (256) 
8. #define THREAD LED PRIORITY (5) 
9. #define THREAD LED SLICE (20) 
10. 


11. #define THREAD CTRL STACK SIZE (256) 
12. #define THREAD CTRL PRIORITY (6) 
13. #define THREAD CTRL SLICE (20) 


1 

用 户 线程 栈 定义 */ 

16. static TWord ThreadLEDOnStack[THREAD LED STACK SIZE]; 
17. static TWord ThreadLEDOffStack{[THREAD LED STACK SIZE]; 
18. static TWord ThreadCTRLStack [THREAD CTRL STACK SIZE]; 
19. 
20%. 六 
用 户 线程 定义 */ 

21. static TThread ThreadLEDOn; 
22. static TThread ThreadLEDOff; 
23. static TThread ThreadcTRL; 
24. 


用 户 事件 标记 */ 

26. static TFlags LedFlags; 

27. #define LED] ON FLG (0x1<<0) 
28. #define LED2 ON FLG (0x1<<1) 
29. #define LED3 ON FLG (0x1<<2) 








31. #define LED1 OFF FLG (0x1<<4) 
32. #define LED2_OFF FLG (0x1<<5) 
33. #define LED3_ OFF FLG (0xl<<6) 


36. /* LED 

线程 的 主 函数 */ 

37. static void ThreadLEDOnEntry (void* pArg) 
3 这 

39, TState state; 

40. TBitMask pattern; 
41. TErrno errno; 

42. TOption option; 
43. 

44. while (eTrue) 

45. { 


46. /* LED 
线程 以 阻塞 方式 获取 事件 ， 得 到 后 点 亮 LED */ 
47. pattern = LIED1 ON FLG | LED2 ON FLG | LED3 ON FLG; 
48. option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 
49. 
E53 罗 state = TclReceiveFlags (&LedFlags, &pattern, option, 0, &errno); 
Sis if (state 一 eSuccess) 
3S { 
Sd. if (pattern & LED]1 ON FLG) 
{ 






54. 

55; EVB LEDControl (LED1, LED ON); 
56. } 和 

DY: 

SH if (pattern & LED2 ON FLG) 

59, { 

60. EVB_LEDControl (LED2, LED ON); 
61. } 

62 . 

63 . if (pattern & LED3 ON_FLG) 

64. 于 

65 . EVB_LEDControl (LED3, LED ON); 
66. } 

67. } 

68. } 

9 

70. 

RE 

72. /* LED 

线程 的 主 函数 */ 

73. static void ThreadLEDOffEntry (void* pArg) 

































74. { 
5 TState state; 
76. TBitMask pattern; 
党 TErrno errno; 
78 TOption option; 
19; 
80. while (eTrue) 
81. { 
82 . /* LED 
线程 以 阻塞 方式 获取 事件 ， 得 到 后 熄灭 LED */ 
83. Pattern = LED1 OFF FLG | LED2 OFF FLG | LED3 OFF FLG; 
84. option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 
85. 
86. state = TclReceiveFlags (&LedF1ags，&pattern，option，0，&errno) 7 
87. if (state 一 eSuccess) 
88. 
89 . if (pattern & LED1_OFF FLG) 
890 { 
8 EVB LEDControl (LED1, LED OFF) 
92. } - 
93 
94. if (pattern & LED2 OFF FLG) 
95. : 
96 . EVB_LEDControl (LED2, LED OFF) 
97; : 
98 . 
99 . if (pattern & LED3 OFF FLG) 
100. { 
101. EVB LEDControl (LED3, LED OFF); 
102. } 
103. } 
104. } 
105. } 
106. 
WO VE 
主 控 线 程 的 主 函数 */ 
108. static void ThreadCTRLEntrY (void* pArg) 
Je 于 
110. while (eTrue) 
Ta 
4 
主 控 旨 
Ei TclSendFlags (&LedFlags, LED]1 ON FLG); 
114. 
TLS 和 
主 控 旨 
和 
116. TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 
1 
了 件 标记 */ 
来 TclSendFlags (&LedFlags, LED2 ON FLG); 
1 
1 a 
TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 
/* 
件 标记 */ 














TclSendFlags (&LedFlags, LED3 ON FLG); 


六 
线程 延 时 1 

TclDelayThread (uThreadCurrent，MLS2TICKS (1000) ) 7 
/* 


线程 释放 事件 标记 */ 
TclSendFlags (&LedF1ags，LED1_OFF FLG | LED2 OFF FLG) 





/* 


线程 延 时 1 


TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 


/* 
得 释放 事件 标记 */ 
TclSendFlags (&LedFlags, LED3 OFF FLG); 





x 








线程 延 时 1 


TclDelayThread (uThreadCurrent, MLS2TICKS (1000)); 





145. /* 
用 户 应 用 入 口 函 数 */ 
146. static void APP LEDEnNtry (void) 














二 汪 

148 . TErrno errno; 

149. 

150. Vi 

配置 使 能 评估 板 上 的 LED 

设备 */ 

le EVB_LEDConfig(); 

5 

153 A 

初始 化 事件 标记 */ 

154. TclInitFlags (&LedFlags, IPC PROP NONE, &errno); 

155; 

456, /* 

初始 化 LED 

设备 控制 线程 */ 

汪汪 学 TclInitThread (&ThreadLEDOnNn, &ThreadLEDONENtry, (void*)NULL, 
十 58 ThreadLEDOnStack, THREAD LED STACK SIZE, 
159. THREAD LED PRIORITY, THREAD LED SLICE); 
160. 

161. TclInitThread (&ThreadLEDOff, &ThreadLEDOffEntry, (void*)NULL, 
162. ThreadLEDOffStack, THREAD LED STACK SIZE, 
LT63 THREAD LED PRIORITY, THREAD LED SLICE); 
164. 

165 . A 

初始 化 CTRL 

线程 */ 

166. TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
167. ThreadCTRLStack, THREAD CTRL STACK SIZE, 
168. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
169. 

0, /* 

激活 LED 

线程 */ 

171. TclActivateThread (&gThreadLEDON); 

Ey TclActivateThread (&ThreadLEDOff); 

173. 

174. Fe 

激活 主 控 线程 */ 

于 3 和 TclActivateThread (&ThreadCTRL); 

TP 

T9734 

i 达 

处 理 器 BOOT 

之 后 会 调用 main 


函数 ， 必 须 提供 */ 


179. int main (void) 





180， +{ 

181. 

注册 处 理 器 初始 化 函数 到 内 核 */ 

182 . TclSetCpuEntry (&CPU_STM32F10xInit); 
二 SS 

184. /* 

注册 板 级 初始 化 函数 到 内 核 */ 

199;, TclSetBoardEntry (&EVB_SetupBoard); 
186. 

187. 7 

注册 板 级 调试 打印 函数 到 内 核 */ 

188 . TclSetTraceRoutine (&EVB UartlWriteString); 
189, 

190. I 

注册 用 户 初始 化 函数 到 内 核 */ 

191. TclSetUserEntry (&APP LEDENtry); 
192. 

193. 1 

启动 内 核 */ 

194. TclStartKernel (); 

9s 

196. return. Ts 

be 

198, 

199. #endif 








程序 运行 后 ，LED 的 变化 如 图 8-11 所 示 。 











LEDI 
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图 8-11 LED 的 变化 情况 


8.3.2 ”线程 和 ISR 间 的 同步 


在 本 例 中 事件 被 定义 为 LED 的 控制 命令 。 然 后 一 个 LED 线 程 从 事件 标记 中 接收 事件 ， 事 件 的 内 容 决定 LED 的 点 亮 或 者 熄灭 。 用 户 通 过 外 部 按键 中 断 来 激活 KeylISR， 在 该 ISR 中 ， 会 交 蔡 发 送 LED 点 亮 和 熄 
灭 的 事件 ， 从 而 实现 LED 按 照 用 户 按键 的 操作 点 亮 和 熄灭 。 


在 这 个 例 程 里 ，LED 线 程 和 KeylSR 的 数据 传输 是 单 向 的 ， 并 且 是 异步 的 。LED 线 程 的 执行 则 依赖 于 KeylSR， 而 KeylSR 的 运行 是 不 确定 的 。 程 序 实 现 如 代码 清单 8-2 所 示 。 


代码 清单 : 8-2 





#include "example.h" 
#inclugde “trochili.h" 


#if (EVB EXAMPLE == CH8_FLAGS FXAMPLF2) 


5 

户 线程 参数 */ 

#define THREAD CTRL STACK SIZE (256) 
#define THREAD CTRL PRIORITY (6) 
#define THREAD CTRL SLICE (20) 


ioD 酒 maemw 


二 

用 户 线程 栈 定义 */ 

12. static TWord ThreadCTRLStack[THREAD CTRL STACK SIZE]; 
3 

14. /* 

用 户 线程 定义 */ 

15. static TThread ThreadCTRL; 
> 

a 

用 户 事件 标记 */ 

18. static TFlags LedFlags; 

19. #define LED1 ON FLG (0x1<<0) 
20. #define LED2 ON FLG (0x1<<1) 
21. #define LED3 ON FILG (0x1<<2) 
22. 

23. #define LED1 OFF FLG (0x1<<4) 
24. #define LED2 OFF FLG (0x1<<5) 
25. #define LED3 OFF FLG (0x1<<6) 











26. 

党 

28. /* LED 

线程 的 主 函数 */ 

29. static void ThreadCTRLENtry (void* pArg) 

30. +{ 

BL TState state; 

32: TBitMask pattern; 

3 TErrno errno; 

34. TOption option; 

35: 

36。 while (eTrue) 

3 { 

38. /* LED 

线程 以 阻塞 方式 获取 事件 ， 得 到 后 熄灭 LED */ 

3 pattern = LED1 OFF FLG | LED1 ON FLG; 
40. option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 
41. 

42. state = TclReceiveFlags (&LedFlags, é&pattern, option, 0, &errno); 
43. if (state 一 eSuccess) 

44. { 

45. if (pattern & LED1 OFF FLG) 

46. { 

47. EVB_LEDControl (LED1, LED OFF); 
48. bE: 

49. 

50 . if (pattern & LED1_ ON _FLG) 

351, { 

3 EVB_LEDControl (LED1, LED ON); 
33 } 

54. } 

55. bE: 

56. } 

SS 

58. 


59- /* 

评估 板 按键 中 断 处 理 函数 */ 

60. static void EVB KeyISR (TVector vector, TProperty Property, TWord data) 
2 

62. static TWord cmd = 0; 

63. if (EVB KeyScan()) 





64. 


65. /* Key ISR 

以 非 阻塞 方式 ( 

必须 ) 

发 送 事件 标记 */ 

66. Cmd+ 十 7 

67、 if (cmd %$ 2) 

68 . { 

69. TclSendFlags (&LedFlags, LED] OFF FLG); 
了 98。 } 

2 else 

72. { 

3 TclSendFlags (&LedFlags, LED]1 ON FLG); 
74. } 

75。 } 

76. } 

77. 


78. /* 
用 户 应 用 入 口 函 数 */ 
79. static void APP LEDEntry (void) 





80. { 

1: TErrno errno; 

82 . 

83. 六 

配置 使 能 评估 板 上 的 LED 

和 KEY 

设备 * 

84. EVB_LEDConfig(); 
85。 EVB KeyConfig(); 
86. 

87. 区 

设置 和 KEY 
相关 的 外 部 中 断 向 量 */ 

88 . TclSetIntVector (KEY_INT VECTOR, &EVB KeyISR, 0); 
9 

90 . 2 

初始 化 事件 标记 */ 

91. TclInitFlags (&LedFlags, IPC PROP NONE, &errno); 
92, 

93. ee 

初始 化 CTRL 


TclInitThread (&ThreadCTRL, &ThreadCTRLENtry, (void*)NULL, 
ThreadCTRLStack, THREAD CTRL STACK SIZE, 
THREAD CTRL PRIORITY, THREAD CTRL SLICE); 






1 
E 控 线程 */ 
TclActivateThread (&ThreadCTRL); 











器 BOOT 
之 后 会 调用 main 
函数 ， 必 须 提供 */ 
104. int main (void) 
105. 1 
106. Fi 
注册 处 理 器 初始 化 函数 到 内 核 */ 
107. TclSetCpuEntry (&CPU_STM32F10xInit); 
108. 
109. 人 
注册 板 级 初始 化 函数 到 内 核 */ 
10 TclSetBoardEntry (&EVB_SetupBoard); 
11s 
112。 Ly 
注册 板 级 调试 打印 函数 到 内 核 */ 
113; TclSetTraceRoutine (&EVB UartlWriteString); 
114. 
115. 六 
注册 用 户 初始 化 函数 到 内 核 */ 
116 . TclSetUserEntry (&APP LEDENtry); 
Is 
118. LA 
启动 内 核 */ 
L119 TclStartKernel (); 
120。 
121， return 1; 
122. } 
123; 
124. #endif 

















该 例子 运行 结果 不 方便 图 示 ，LED 灯 会 随 着 用 户 键 的 按 下 不 停 地 点 亮 或 熄灭 。 




















8.3.3 ”多 线程 同步 与 事件 标记 刷新 























本 例 实现 多 个 LED 线 程 和 1 个 控制 线程 的 单 向 同步 (没有 数据 传输 ) 。 实 现 三 个 LED 分 别 按照 1 秒 的 间隔 点 亮 和 熄灭 。 这 里 使 用 了 1 个 事件 标记 。 具 体 实现 时 ， 多 个 LED 线 程 的 线程 函数 相似 ， 都 是 以 阻塞 
方式 从 同一 事件 标记 读 取 事 件 ， 目 的 是 阻塞 在 事件 标记 的 线程 阻塞 队列 上 ， 使 得 多 个 线程 的 执行 路 径 交 汇 在 一 起 。 而 控制 线程 则 是 每 隔 1 秒 对 事件 标记 进行 一 次 刷新 操作 ， 使 得 那些 阻塞 在 事件 标记 线程 阻塞 
队列 上 的 线程 都 解除 阻塞 。 程 序 实现 如 代码 清单 8-3 所 示 。 











代码 清单 : 8-3 





#include "example.h" 


过 
2. #include "trochili.h" 

3 

4 #if (EVB EXAMPLE == CH8_FLAGS FXAMPLE3) 
5 

6 


Se 
用 户 线程 参数 */ 
7. #define THREAD LED STACK SIZE (256*2) 


8. #define THREAD LED PRIORITY (5) 
9. #define THREAD LED SLICE (20) 
10. 


11. #define THREAD CTRL STACK SIZE (256*2) 
12. #define THREAD CTRL PRIORITY (4) 

13. #define THREAD CTRL SLICE (20) 
14. 

LJ 

用 户 线程 定义 */ 

16. static TThread ThreadLEDO; 
17. static TThread ThreadLED17 
18. static TThread ThreadLED27 
19. static TThread ThreadCTRL; 
20. 

BL 

用 户 线程 栈 定义 */ 

22. static TWord ThreadLEDStack0 
23. static TWord ThreadLEDStackl 
24. static TWord ThreadLEDStack2 
25. static TWord ThreadCTRLStack 
26. 

用 户 事件 标记 定义 */ 


THREAD LED STACK SIZE] 
THREAD LED STACK SIZE] 
THREAD LED STACK SIZE] 
THREAD CTRL STACK SIZE 


1; 


28. static TFlags LedFlags; 





9 

30. /* LED 

线程 0 

的 主 函数 */ 

31. static void ThreadLEDOEntry (void* pArg) 
325 站 

33, TState state; 

34. TErrno errno; 

35; TBitMask pattern; 
36; TOption option; 
37. 

38. while (eTrue) 

9 { 


40. /* LED 

线程 以 阻塞 方式 获取 事件 ， 当 发 现 事件 标记 flush 
后 点 亮 LED */ 
41. 








pattern = 0xa0; 


42. option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 

43. state = TclReceiveFlags (&LedFlags, &pattern, option, 0, &errno); 
44. if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 

45. 

46. EVB_LEDControl (LED1, LED ON); 

47. 4 

48 . 


49., /* LED 
线程 以 阻塞 方式 获取 事件 ， 当 发 现 事件 标记 flush 
后 熄灭 LED */ 








50 . Pattern = 0xa0; 

SLs option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 
全 state = TclReceiveFlags (&LedFlags, &pattern, option, 0, &errno); 
3 if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 

54. 

Eas EVB LEDControl (LED1, LED OFF); 

56. } 号 加 

ST } 

5 和 <。 于 

S59 

60. /* LED2 


线程 的 主 函数 */ 


61. static void ThreadLEDlEntry (void* pArg) 
G7 

63. TState state; 

64. TErrno errno; 

65. TBitMask pattern; 

66. TOption option; 

67. 

68 . while (eTrue) 

69. { 


70. /* LED 

线程 以 阻塞 方式 获取 事件 ， 当 发 现 事件 标记 flush 
后 点 亮 LED */ 
71. 








Pattern = 0xal; 


23 option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 

和 state = TclReceiveFlags (&LedFlags, g&pattern, option, 0, &errno); 
74. if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 

35» 

76. EVB LEDControl (LED2, LED ON); 

77. 加 多 

98 


79. /* LED 
线程 以 阻塞 方式 获取 事件 ， 当 发 现 事件 标记 flush 
后 熄灭 LED */ 





80 pattern = 0xal; 

81. option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 
82. state = TclReceiveFlags (&LedFlags, g&pattern, option, 0, &errno); 
83. if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 

84. 

85 . EVB_LEDControl (LED2, LED OFF); 

86. } 

了 > } 

88. 1} 

89 . 

90. /* LED2 


线程 的 主 函数 */ 


91. static void ThreadLED2Entry (void* pArg) 
92, 4 

5 TState state; 

94. TErrno errno; 

95. TBitMask pattern; 

96. TOption option; 

a7 

98 . while (eTrue) 

99. + 

100. /* LED 


线程 以 阻塞 方式 获取 事件 ， 当 发 现 事件 标记 flush 
后 点 亮 LED */ 





101 . Pattern = 0xa2; 

102. option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 

103. state = TclReceiveFlags (&LedFlags, &pattern, option, 0, &errno); 
104. if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 

105. : 

106. EVB LEDControl (LED3, LED ON); 

107. } 加 VW 

108. 

109. /* LED 





线程 以 阻塞 方式 获取 事件 ， 当 发 现 事件 标记 flush 


后 熄灭 LED */ 
110. 

LT 

112. 

3 

114. 

TIS 

116. 

117. 让 
118. } 
119. 

120. 

121. 


2 这 














123. 
124. { 
125. 
126. 
127. { 
128. 
主 控 线程 延 时 1 
后 FLUSH 
件 标记 */ 
129. 

130. 

131. } 
132 
133. 
134. 
135. 









Sk 


pattern = 0xa2; 

option IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 
state = TclReceiveFlags (&LedFlags, g&pattern, option, 0, &errno); 
if ((state != eSuccess) && (errno & ERR IPC FLUSH)) 

{ 


EVB_LEDControl (LED3, LED OFF); 
} 


主 控 线程 的 主 函 数 */ 
static void ThreadCTRLENtry (void* pArg) 


TErrno errno; 
while 


(eTrue) 


/* 


TclDelayThread (&ThreadCTRL, MLS2TICKS (1000)); 
TclFlushFlags (&LedFlags, &errno); 


用 户 应 用 入 口 函 数 */ 


36s 
Ty 
J38 
39 


static void APP LEDENtry (void) 


TErrno errno; 


140. 2 
板 级 初始 化 函数 */ 


141. 
142 . 


EVB_SetupBoard (); 


143. Ws 
配置 使 能 评估 板 上 的 LED 


设备 */ 








144. EVB LEDConfig(); 

145. I 

146. Fs 

初始 化 事件 标记 */ 

147. TclInitFlags (&LedFlags, IPC PROP NONE, &errno); 

148. 

149. 全 

初始 化 LED 

设备 线程 */ 

Sa TclInitThread (&ThreadLED0， &ThreadLEDOEntry， (void*)NULL, 
151. ThreadLEDStack0, THREAD LED STACK SIZE, 
152. THREAD LED PRIORITY, THREAD LED SLICE); 
153, 

154. TclInitThread (&ThreadLED1， &ThreadLED1Pntry， (void*)NULL, 
155. ThreadLEDStackl, THREAD LED STACK SIZE, 
156. THREAD LED PRIORITY, THREAD LED SLICE); 
i157 

158 . TclInitThread (&ThreadLED2， &ThreadLED2EnNntry, (void*)NULL, 
159。 ThreadLEDStack2, THREAD LED STACK SIZE, 
160. THREAD LED PRIORITY, THREAD LED SLICE); 
让 

162. 

初始 化 CTRL 

线程 */ 

163. TclInitThread (&ThreadCTRL， &ThreadCTRLENtry, (void*)NULL, 
164. ThreadCTRLStack, THREAD CTRI STACK SIZE, 
165. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
166. 

i167 Rt 

激活 LED 

线程 */ 

168. TclActivateThread (&ThreadLEDO); 

169 . TclActivateThread (&ThreadLEPD1) 

二 Da TclActivateThread (&ThreadLED2); 

TE 

172. 

激活 主 控 线程 */ 

L713 TclActivateThread (&gThreadCTRL); 

174. } 

175, 

76。  /* 

处 理 器 BOOT 

之 后 会 和 有 

函数 ， 必 须 提供 */ 

177. int main (void) 

18s + 

179: J 

注册 处 理 器 初始 化 函数 到 内 核 */ 

180. TclSetCpuEntry (&CPU_STM32F10xInit); 

181: 

182. 六 

注册 板 级 初始 化 函数 到 内 核 */ 

183. TclSetBoardEntry (&EVB_SetupBoard); 

184. 

185. 六 

注册 板 级 调试 打印 函数 到 内 核 */ 

186 . TclSetTraceRoutine (&EVB_Uart1WNriteString) 7 

187s 

188 . Le 

注册 用 户 初始 化 函数 到 内 核 */ 

189. TclSetUserEntry (&APP LEDENtry); 

Labs 

84.。 

启动 内 核 */ 

192. TclStartKernel (); 

193. 

194. return 1; 

195。 了 

196. 

TT 

198. #endif 








程序 运行 后 ，LED 的 变化 如 图 8-12 所 示 。 


LED3 


LED2 


LED1 


8.3.4 


在 本 例 中 ， 事 件 被 定义 为 LED 的 控制 命令 。 然 后 两 个 线程 通过 的 事件 标记 ， 发 送 和 接收 事件 ， 从 而 实现 LED 按 照 1 秒 的 间隔 点 





按照 1 秒 的 间隔 
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强制 解除 线程 阻塞 
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TS TI6 


8-12 LED 的 变化 情况 














工 7 


其 中 LED 线 程 则 不 停 地 以 阻塞 方式 尝试 接收 事件 ， 然 后 进行 LED 的 控制 : 如 果 是 线程 LED 被 解除 阻塞 则 点 亮 LED， 然 后 再 次 尝 
件 标记 ， 初 始 化 事件 标记 ， 循 环 往复 。 程 序 实现 如 代码 清单 8-4 所 示 。 


亮 和 熄灭 。 


试 接收 事件 ; 如 果 是 事件 标记 再 次 被 解除 阻塞 则 熄灭 LED， 主 控 线 程 不 停 地 


代码 清单 : 8-4 





1. #include "example.h" 
2. #include "trochili.h" 
Ys 

4. #if (EVB EXAMPLE == CH8_ FLAGS EXAMPLE4) 
:oe 

6。 /* LED 

设备 参数 */ 

7. #define LED ON (1) 
8. #define LED OFF (0) 
9. #define LED INDEX (1) 
证 


Nag #/ 
#define THREAD LED STACK SIZE (256*2) 


13: #define THREAD LED PRIORITY (5) 
14. #define THREAD LED SLICE (2000) 
15. 


16. #define THREAD CTRL STACK SIZE (256*2) 
17. #define THREAD CTRI PRIORITY (4) 


18. #define THREAD CTRL SLICE (2000) 
19. 
和 月 栈 定义 */ 


21. static TThread ThreadLED; 

22. static TThread ThreadcTRL; 

3 

SA. /* 

名 入 要 定义 * 

25. static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
26. static TWord ThreadCTRLStack[THREAD CTRL STACK SIZE]; 
27 

380 

用 户 事件 标记 定义 */ 

29. static TFlags LedFlags; 








30 . 
31. /* LED 
数 */ 
static void ThreadLEDEntry (void* pArg) 
34. TState state; 
35, TErrno errno; 
36. TBitMask pattern; 
2 TOption option; 
3 
39. while (eTrue) 
0 
/* LED 


扩 和 六 式 代 取 于 伯 ， 被 强制 解除 阻塞 后 点 亮 LED */ 
Pattern = 0x17 


人 option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 
44. state = TclReceiveFlags (&LedFlags, gpattern, option, 0, &errno); 
45. if ((state != eSuccess) && (errno & ERR IPC ABORT)) 
46. { 
47. EVB_LEDControl (LED INDEX, LED ON); 
48. } 
* LED 


妆 委 办 广 式 人 下 被 强制 解除 阻塞 后 熄灭 LED */ 


pattern = 0x17 


2 cption = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 
3 state = TclReceiveFlags (&LedFlags, gpattern, option, 0, &errno); 


54. if ((state != eSuccess) && (errno & ERR IPC ABORT)) 
55 

56. EVB_LEDControl (LED INDEX, LED OFF); 
$7 } 

38 } 

59. 

60 . 

61 . 

Gf 

主 控 线程 的 主 函数 */ 

63. static void ThreaqCTRLEntry (void* pArg) 








TErrno errno; 





/* 
得以 阻塞 方式 获取 事件 标记 */ 
while (eTrue) 


{ 


伴 线 程 延 时 1 
秘 后 强制 解除 LED 


线程 的 阻塞 */ 

11 TclDelayThread (&ThreadCTRL, MLS2TICKS (1000)); 
12 TclAbortFlags (&LedFlags, &ThreadLED, &errno); 
3 } 

74. 1} 

75。 

76. 

D7 过 兴 

用 户 应 用 程序 入 口 函数 */ 

78. static void APP LEDEntry (void) 


六 

















是 生生 

#0 TErrno errno; 

81. 

Cr Ss 

配置 使 能 评估 板 上 的 LED 

设备 */ 

83. EVB LEDConfig(); 

84. 加 

85 . 

初始 化 事件 标记 */ 

86. TclInitFlags (&LedFlags, IPC PROP NONE, &errno); 

87. 

8. Li 

初始 化 LED 

设备 控制 线程 */ 

89. TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)NULL, 
90. ThreadLEDStack, THREAD LED STACK SIZE, 
91, THREAD LED PRIORITY, THREAD LED SLICE); 
92. 

93 . 

初始 化 CTRL 

线程 */ 

94. TclInitThread (&ThreadCTRL， &ThreadCTRLENtry, (void*)NULL, 
95. ThreadcTRLStack, THREAD CTRL STACK SIZE, 
96. THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
97. 

98 . 过 

激活 LED 

设备 控制 线程 */ 

4。 TclActivateThread (&ThreadqLED) 

i100 

101. 2 

激活 主 控 线程 */ 

102. TclActivateThread (&ThreadCTRL); 

103. } 

104. 

L058. ./* 

处 理 器 BOOT 

之 后 会 调用 main 


函数 ， 
必须 提供 */ 


106. int main (void) 


0734 

108. 

注册 处 理 器 初始 化 函数 到 内 核 */ 

109. TclSetCpuEntry (&CPU_STM32F10xInit); 
110. 

1 1s 

注 测 板 级 初 化 西数 到 内 核 */ 

112. TclSetBoardEntry (&EVB_SetupBoard); 
13s 

114. ja 

注册 板 级 调试 打印 函数 到 内 核 */ 

115, TclSetTraceRoutine (&EVB UartlWriteString); 
Ti6. 

T17。 

注册 用 户 初始 化 函数 到 内 核 */ 

了 98， TclSetUserEntry (&APP LEDENtry); 
119, 

120, A 

启动 内 核 */ 

1 TclStartKernel (); 

122 ， 

123s return 1; 

124. } 

125. 

126. #endif 








程序 运行 后 ，LED 的 变化 如 图 8-13 所 示 : 
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8.3.5 ”事件 标记 重 置 


在 本 例 中 ， 两 个 线程 通过 的 事件 标记 实现 LED 按 照 1 秒 的 间隔 点 亮 和 熄灭 。 























| 





件 ; 如 果 是 事件 标记 再 次 被 重 置 则 熄灭 LED;， 主 控 线程 不 停 地 按照 1 秒 的 间隔 重 置 事件 标记 ， 初 始 化 事件 标记 ， 循 环 往复 。 程 序 实现 如 代码 清单 8-5 所 示 。 











代码 清单 : 8-5 


1 6: EY 


8-13 LED 的 变化 情况 














时 间 


其 中 LED 线 程 则 不 停 地 以 阻塞 方式 尝试 接收 事件 ， 然 后 进行 LED 的 控制 : 如 果 是 线程 LED 被 重 置 则 点 亮 LED， 然 后 再 次 尝试 接收 





#include "example.h" 
#inclugde "trochili.h" 


#if (EVB EXAMPLE 一 CH8_FLAGS EXAMPLES5) 


/* LED 
设备 参数 */ 
#define LED ON (1) 
#define LED OFF (0) 
#qdefine LED INDEX (1) 


oA DOpP 


用 户 线程 参数 */ 

12. #define THREAD LED STACK SIZE (256*2) 
13. #define THREAD LED PRIORITY (5) 

14. #define THREAD LED SLICE (20) 


16. #define THREAD CTRL STACK SIZE (256*2) 
17. #define THREAD CTRL PRIORITY (43 
18. #define THREAD CTRL SLICE (20) 


20. 

基准 程 定义 二 

21. static TThread ThreadLED; 

22. static TThread ThreadCTRL” 

3 

2 

用 户 线程 栈 定义 */ 

25. static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
26. static TWord ThreadcTRLStack [THREAD CTRL STACK SIZE]; 
2 

BR 

用 户 事件 标记 定义 */ 

29. static TFlags LedFlags; 

30. 
31. /* LED 

线程 的 主 函数 */ 

32. static void ThreadLEDENtry (void* pArg) 





33. { 

34. TState state; 

25 TBitMask pattern; 
30 TErrno errno; 

37 . TOption option; 








39。 while (eTrue) 

40 . { 

41. /* LED 

线程 以 阻塞 方式 获取 事件 ， 

当 发 现 事件 标记 重 置 后 点 亮 LED */ 
42 . Pattern = 0x17 











43. option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 

44. state = TclReceiveFlags (&LedFlags, &pattern, option, 0, &errno); 
45. if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 

46. 4 

47. EVB LEDControl (LED INDEX, LED ON) 

48 . } 出 本 加 

49 . 


50 . /* LED 
线程 以 阻塞 方式 获取 事件 标记 ， 
当 发 现 事件 标记 重 置 后 熄灭 LED */ 














Ss Pattern = 0x17 

B23 option = IPC OPT WAIT | IPC OPT FLAG OR | IPC OPT CONSUME; 
3 state = TclReceiveFlags (&LedFlags, g&pattern, option, 0, &errno); 
54. if ((state != eSuccess) && (errno & ERR IPC DEINIT)) 

Dos . 

56s EVB_LEDControl (LED INDEX, LED OFF); 

5 4 

58 . 

Eo 

60. 

61. 

B24 





主 控 线程 的 主 函 数 */ 
63. static void ThreadCTRLENtry (void* pArg) 











64. { 

65. TErrno errno; 
66. while (eTrue) 
67. 本 

68 . /* 

主 控 线 程 延 时 1 





秒 ， 此 后 LED 
线程 才 得 到 运行 机 会 */ 
69. TclDelayThread (&ThreadCTRL, MLS2TICKS (1000) ) 7 





71. 2 
主 控 线 程 重 置 事件 标记 */ 

3 TclDeinitFlags (&LedFlags, &errno); 

J TclInitFlags (&LedFlags, IPC PROP NONE, &errno); 
74. } 

Se 球 

76. 

hs 

A 

用 户 应 用 入 口 函 数 */ 

79. static void APP LEDEntry (void) 











30;, 4 
81. TErrno errno; 
2 
四 地。 2/ 
使 能 评估 板 上 的 LED 
EVB_LEDConfig(); 
/* 
tLED 
件 标记 */ 
TclInitFlags (&LedFlags, IPC PROP NONE, &errno); 
js 
CLED 


控制 线程 */ 
TclInitThread(&ThreadLED, &ThreadLEDENntry, (void*)NULL, ThreadLEDStack, 
?THREAD LED STACK SIZE, THREAD LED PRIORITY, THREAD LED SLICE); 

















/* 
LCTRL 
程 */ 
TclInitThread (&ThreadCTRL， &ThreadCTRLENtry, (void*)NULL, ThreadCTRLStack, 
THREAD CTRL STACK SIZE, THREAD CTRL PRIORITY, THREAD CTRL SLICE); 
A* 
激活 LED 
线程 */ 
TclActivateThread (&ThreadLED); 
pe 
激活 主 控 线 程 */ 
ois TclActivateThread (&ThreadCTRL); 
102;. | 
9093。 
104. 
8 
处 理 器 BOOT 
之 后 会 调用 main 
函数 ， 必 须 提供 */ 
106. int main (void) 
107. { 
108 . 
注册 处 理 器 初始 化 函数 到 内 核 */ 
LT09. TclSetCpuEntry (&CPU_STM32F10xInit); 
J10., 
了 /* 
注册 板 级 初始 化 函数 到 内 核 */ 
二 二 友人 TclSetBoardEntry (&EVB_SetupBoard); 
113 
114. A 
注册 板 级 调试 打印 函数 到 内 核 */ 
ID TclSetTraceRoutine (&EVB UartlWriteString); 
116. 
让 了 A 
注册 用 户 初始 化 函数 到 内 核 */ 
NE TclSetUserEntry (&APP LEDENtry); 
和 
120's A 
启动 内 核 */ 
Th TclStartKernel (); 
19, 
Le return 1; 
124. } 
125. 
126;, 
127. #endif 








程序 运行 后 ，LED 的 变化 如 图 8-14 所 示 。 
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8-14 LED 的 变化 情况 
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第 9 章 ” 时 间 管 理 


内 核 的 时 间 管理 是 通过 硬件 系统 时 钟 实现 的 。 处 理 器 基本 都 具有 产生 周期 中 断 信号 的 硬件 定时 器 ， 内 核 正 是 基于 这 种 硬件 中 断 来 实现 任务 时 间 片 机 制 和 软件 定时 器 功能 的 。 在 谋 入 式 操作 系统 中 ， 软 件 
定时 器 主要 用 于 任务 的 定时 操作 ， 包 括 任务 延 时 ， 任 务 对 资源 的 有 限时 间 等 待 以 及 用 户 定时 操作 等 。 


本 章 主 要 分 析 内 核 软件 定时 器 的 原理 和 设计 实现 。 任 务 时 间 片 的 机 制 请 参考 前 面相 关 的 章节 。 另 外 像 RTC 时 钟 、 看 门 狗 等 虽然 同样 提供 时 间 管 理 的 功能 ， 但 是 这 些 已 经 超出 本 章 的 讨论 范围 


他 相关 书籍 。 


9.1 “定时 器 机 制 概述 








在 嵌入 式 系统 中 ， 时 钟 和 定时 器 具 


有 非常 重要 的 作 














。 应 




















定时 管理 主要 有 以 下 几 种 。 





9.1.1 简单 计数 方案 


请 参阅 其 





程序 可 以 通过 定时 器 来 完成 各 种 有 计时 需求 的 工作 ， 比 如 任务 的 延 时 、 提 供 周 期 性 的 信号 等 。 不 同 的 内 核 有 不 同 的 定时 器 管理 方式 ， 常 见 的 


这 种 方式 是 把 任务 所 需 的 定时 时 间 转 化 成 内 核 时 间 中 断 的 节拍 数 ， 然 后 保存 在 任务 结构 中 。 在 内 核 每 次 处 理 时 间 中 断 的 时 候 ， 遍 历 所 有 任务 结构 ， 将 延 时 的 节拍 数 减少 1 个 计数 ， 当 计数 为 0 的 时 候 ， 则 


处 理 该 任务 的 定时 工作 。 这 种 方案 实现 起 来 比较 简单 ， 但 是 





图 


如 











9-1 所 示 ， 假 设 内核 中 有 4 个 任务 处 于 延 时 状态 ， 


时 。 算 法 所 需 时 间 随 定时 器 数目 而 变化 。 








进一步 假设 该 内 核 并 没有 将 延 时 任务 放 入 生 


因为 要 遍历 所 有 任务 ， 所 以 处 理 定时 器 所 需要 的 时 间 和 任务 数目 相关 ， 不 适合 有 大 量 任务 并 且 定时 器 数目 不 确定 的 实时 系统 。 


定时 器 按照 链表 方式 管理 ， 那 么 当 内 核 进入 定时 器 中 断 时 ， 需 要 逐个 对 定时 器 进行 操作 ， 将 每 个 定时 器 的 计数 都 减 1， 然 后 判断 该 定时 器 是 否 到 


独 的 线程 队列 来 管理 ， 那 么 定时 器 的 一 次 滴答 减少 的 操作 就 要 遍历 内 核 的 全 部 任务 ， 可 想 性 能 是 多 么 糟糕。 








9.1.2 ”差分 计时 队列 方案 


另 一 种 常见 的 机 制 是 差分 计时 队列 。 在 内 核 中 设置 一 个 定时 器 指针 ， 所 有 需要 定时 的 任务 都 会 通过 内 核 将 其 使 


图 9-1 


简单 定时 器 队列 管理 

















的 定时 器 放 入 内 核 差分 计时 队列 中 。 此 时 队列 中 的 定时 器 的 定时 计数 并 不 是 任务 所 要 求 





的 原始 数值 ， 而 是 经 过 计算 处 理 后 的 结果 ， 如 下 例 描述 。 





假设 某 个 时 刻 内核 中 有 A、B、C、D 四 个 任务 ， 分 别 需要 延 时 2、5、4、7 个 时 钟 节拍 ， 它 们 按照 顺序 先后 申请 延 时 操作 。 因 为 A 任 务 的 定时 器 首先 进入 内 核 差分 计时 队列 ， 所 以 它 的 定时 计数 就 是 2， 之 
后 任务 B 的 定时 器 又 需要 进入 内 核 差分 计时 队列 ， 那 么 它 的 定时 计数 就 不 应 该 是 5 而 是 3， 需 要 和 它 前 面 的 所 有 定时 计数 相 减 ; 随后 任务 C 的 定时 器 又 需要 进入 内 核 差分 计时 队列 ， 那 么 任务 C 的 定时 器 定时 计 
数 首先 减 去 任务 A 的 定时 器 定时 计数 变 为 2， 然 后 又 发 现 它 此 时 的 定时 计数 不 大 于 任务 B 的 定时 计数 ， 那 么 就 将 任务 C 的 定时 器 放 在 任务 A 和 任务 B 的 定时 器 之 间 ， 并 且 将 任务 B 的 定时 计数 减 去 任务 C 的 定时 计 
数 。 此 时 内 核 差分 计时 队列 的 计时 器 的 顺序 是 A、C、B， 定 时 计数 是 2、2、1。 同 理 ， 当 任务 D 的 定时 器 加 入 内 核 差分 计时 队列 后 ， 内 核 差分 计时 队列 的 计时 器 的 顺序 是 A、C、B、D， 定 时 计数 是 2、2、 
1、2。 如 图 9-2 所 示 。 


前 ”| 任务 A (2 ) 任务 B (5) 任务 C (4) 任务 D (7) 























后 ”| 任务 A (2) 任务 C (2) 任务 B (1) 任务 D (2 ) 


图 9-2 ”差分 计时 队列 


内 核 在 每 个 时 间 节 拍 中 断 中 ， 都 会 把 内 核 差 分 计时 队列 的 第 一 个 计时 器 的 定时 计数 减 1， 相 当 于 队列 中 所 有 定时 器 的 定时 计数 都 减 1。 当 队 首 的 定时 器 的 定时 计数 为 0 时 ， 说 明 该 定时 器 到 时 ， 此 时 需要 
将 该 定时 器 从 队列 中 移出 ， 并 且 将 其 所 对 应 的 任务 唤醒 。 需 要 注意 的 是 ， 此 时 可 能 有 多 个 定时 器 同时 到 时 。 








和 前 面 简单 的 定时 管理 机 制 相 比 ， 在 处 理 差分 计时 队列 时 ， 并 不 需要 遍历 所 有 任务 ， 只 是 处 理 队列 头 即 可 ， 这 样 定时 计数 操作 效率 高 了 很 多 。 缺 点 是 在 把 定时 器 加 入 队列 的 过 程 中 需要 遍历 队列 中 的 部 
分 或 者 全 部 定时 器 ， 这 个 操作 的 时 间 是 不 国定 的 。 还 有 就 是 同时 延 时 结束 的 定时 器 的 数目 是 不 确定 的 ， 所 以 处 理 定时 器 的 过 程 所 耗 的 时 间 也 是 不 确定 的 。 














9.1.3 ”时 间 车 轮 方案 











还 有 一 种 常见 的 内 核 延 时 方式 是 时 间 车 轮机 制 。 时 间 车 轮 是 一 个 固定 长 度 的 数组 ， 其 中 每 个 元 素 称 为 一 个 时 间 槽 ， 代 表 一 个 时 钟 节拍 ， 如 果 时 钟 节拍 是 100ms 发 生 一 次 ， 那 么 每 个 时 间 槽 代表 100ms， 
同时 这 个 数值 也 是 定时 机 制 的 定时 精度 。 每 个 时 间 模 的 内 容 是 一 个 定时 器 链表 的 指针 ， 指 向 在 这 个 时 间 点 到 时 的 全 部 定时 器 。 时 间 车 轮 数组 的 长 度 就 是 它 一 次 处 理 的 最 大 定时 长 度 ， 如 图 9-3 所 示 。 
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图 9-3 时间 车 轮 

















内 核 在 每 个 时 钟 节拍 1ISR 中 都 会 处 理 时 间 游 标 所 在 的 时 间 模 的 定时 器 队列 ， 内 核 需 要 将 队列 中 的 所 有 定时 器 释放 并 且 激 活 相应 的 任务 。 随 后 ， 时 间 游 标 指向 下 一 个 时 间 槽 。 如 果 时 间 游 标 处 在 时 间 车 轮 数 
组 的 最 后 一 个 元 素 ， 需 要 将 时 间 游 标 翻转 到 时 间 车 轮 数 组 的 第 一 个 元 素 ， 完 成 循环 连续 计时 。 





当 一 个 任务 需要 延 时 的 时 候 ， 通 过 内 核 把 它 的 定时 器 加 入 合适 的 时 间 槽 中。 内 核 会 把 任务 定时 器 的 定时 计数 和 时 间 车 轮 的 时 间 游 标 相 比 较 ， 得 到 相对 时 间 游 标的 偏 移 ， 然 后 把 任务 定时 器 加 入 那个 偏 移 
值 所 在 的 时 间 槽 中。 此 时 需要 注意 的 是 ， 如 果 定 时 器 延 时 计数 大 于 时 间 车 轮 的 容量 ， 会 引起 定时 器 延 时 计数 溢出 。 (可 以 考虑 在 计算 偏 移 量 时 ， 首 先 只 计算 定时 计数 相对 于 时 间 模 数目 的 余数 ， 那 么 剩 下 的 
定时 计数 肯定 是 时 间 权 数目 的 整数 倍 。 随 后 在 时 钟 节拍 处 理 的 过 程 中 ， 首 先 会 把 前 面 得 到 的 计时 余数 消耗 掉 ， 然 后 再 根据 剩 下 的 计数 是 否 为 0 来 判断 延 时 是 否 结束 。) 
































和 差分 计时 队列 方案 一 样 ， 因 为 时 间 游 标 所 在 的 时 间 权 指向 的 定时 器 队列 中 ， 定 时 器 的 数目 是 不 一 定 的 ， 所 以 在 时 钟 节拍 1SR 每 次 处 理 到 定时 器 的 时 候 ， 所 消耗 的 时 间 是 不 一 定 的 ， 但 是 时 间 车 轮 加 入 定 
时 器 的 时 间 是 一 定 的 ， 时 间 计 数 操作 (时 间 游 标 下 移 ) 的 时 间 也 是 一 定 的 。 

















不 论 采 用 哪 种 方式 ， 都 要 维护 任务 状态 并 且 不 断 地 减少 其 延 时 计数 ， 当 计数 结束 时 就 及 时 处 理 定时 器 并 且 唤 醒 任 务 ， 达 到 延 时 的 目的 。 每 个 延 时 方案 各 有 优 缺 点 ， 如 表 9-1 所 示 。 











表 9-1 定时 器 方案 比较 


差分 计时 队列 时 间 车 轮 
遍历 队列 中 部 分 甚至 全 
部 定时 器 ， 大 量 比较 操作 ， 


将 定时 天 初始 化 然后 放 和 人 
车 轮 ， 时 间 固 定 


直接 修改 任务 结构 的 延 时 


和 如 计时 | 计数， 时 间 国 定 


时 间 不 固定 
a 遍历 内 核 中 的 全 部 任务 ,| ”将 队 首 的 定时 器 的 延 时 |， 
计时 变化 | 哪怕 是 没有 延 时 需求 的 任务 | 计数 碱 1 ， 时 间 固定 et Pe es 


, | 和 处 理 时 间 游 标 所 处 的 时 

i 直接 修改 任务 结构 的 延 时 | 。 处 理 是 埋 有 定时 器 到 时 ，| 全 让 ee 

四 计数 ， 时 间 固 定 处 理 的 定时 器 数目 不 定 Re 
的 定时 顺 数 目 不 定 








从 表 9-1 可 以 看 出 ， 简 单方 案 只 适合 内 核 中 任务 数目 较 少 并 且 固定 的 情况 。 而 差分 计时 队列 在 开始 计时 的 操作 上 较 时 间 车 轮 方案 差距 很 大 ， 在 定时 任务 较 多 的 情况 下 ， 不 如 时 间 车 轮 方案 。 





9.1.4 ”定时 时 间 漂 移 








在 处 理 延 时 结束 的 定时 器 时 ， 以 上 任何 方案 都 不 能 保证 在 固定 的 时 间 内 完成 ， 这 是 因为 : 
. 定时 器 队列 中 延 时 结束 的 定时 器 的 数目 是 不 国定 的 
. 每 个 定时 器 延 时 结束 时 需要 的 操作 也 是 不 一 样 的 


在 极限 情况 下 ， 如 果 内 核 在 处 理 多 个 定时 器 的 过 程 中 ， 由 于 某 些 原因 导致 在 一 个 时 钟 节拍 内 没有 完成 全 部 定时 器 操作 ， 那 么 内 核 就 会 阻止 下 一 个 时 钟 节拍 中 断 的 发 生 (时 钟 节拍 是 以 中 断 方式 产生 
的 ，ISR 在 处 理 过 程 中 会 屏蔽 自身 使 用 的 硬件 中 断 ) ， 这 将 造成 时 钟 漂移 。 典 型 的 情况 就 是 用 户 回调 类 型 的 定时 器 。 假 如 用 户 任务 安排 了 一 次 定时 操作 ， 但 是 计算 比较 复杂 ， 结 果 在 |SR 调 用 用 户 安排 的 回调 
函数 时 花费 了 太 多 时 间 ， 导 致 中 断 无 法 及 时 重新 打开 ， 造 成 时 钟 节拍 漂移 。 






























































回 
































9.1.5 “定时 器 精度 


每 种 定时 器 模型 都 有 定时 器 精度 的 问题 ， 因 为 每 个 定时 器 都 是 基于 硬件 时 钟 节拍 中 断 的 ， 时 钟 节拍 中 断 的 时 间 间 隔 就 是 定时 器 响应 处 理 的 时 间 间 隔 。 假 如 前 后 两 个 时 钟 节拍 中 断 的 时 间 间 隔 是 100ms， 
那么 250ms 的 定时 器 如 何 处 理 呢 ? 平均 来 讲 ， 误 差 大 概 是 时 钟 节拍 间隔 的 一 半 ， 也 就 是 说 ， 需 要 把 不 够 1 个 时 钟 节拍 的 延 时 时 间 进 行 修正 。 低 于 一 个 时 钟 节拍 的 延 时 功能 是 不 能 通过 软件 定时 器 实现 的 。 





9.2 ”软件 定时 器 功能 设计 








上 节 介绍 了 谋 入 式 系统 中 的 定时 器 的 基本 知识 。 本 节 则 介绍 内 核定 时 器 的 选 型 和 设计 实现 。 因 为 定时 器 是 内 核 的 一 个 关键 部 件 ， 所 以 需要 仔细 考察 各 种 方案 。 在 具体 设计 上 ，Trochili RTOS 主 要 考虑 以 





下 几 点 : 
“ 需要 满足 线程 延 时 的 需求 
. 需要 满足 IPC 时 限 阻塞 的 需求 


“ 需要 满足 用 户 回调 定时 器 的 需求 











最 终 在 实现 时 采用 以 下 方案 : 





“ 采用 差分 计时 队列 算法 来 实现 定时 器 。 
“ 在 内 核 中 内 建 一 个 定时 器 守护 线程 来 实现 用 户 定时 器 功能 ， 即 在 该 线程 中 代理 执行 用 户 注册 的 回调 函数 ， 这 样 可 以 避免 时 钟 漂移 的 问题 。 


“ 内 核 在 每 个 线程 的 结构 中 设置 一 个 定时 器 结构 。 

















在 Trochili RTOS 中 ， 软 件 定 时 器 被 分 为 3 种 ， 分 别 具 有 不 同 的 用 途 : 








. 线程 延 时 定时 器 :将 线程 延 时 一 段 时 间 然 后 恢复 原来 的 状态 。 该 定时 器 被 内 置 在 线程 结构 中 。 

IPC 时 限 阻塞 定时 器 : 线程 阻 赛 在 IPC 资 源 的 线程 阻塞 队列 中 一 段 时 间 ， 如 果 时 间 到 达 还 没 得 到 所 需要 的 资源 则 会 被 唤醒 。 该 定时 器 和 线程 延 时 定时 器 是 同一 个 定时 器 ， 即 线程 内 置 定时 器 ， 只 是 使 用 
目的 不 同 而 已 。 

. 用 户 定时 器 : 用 户 可 以 指定 在 一 段 时 间 后 执行 茶 些 操作 。 用 户 需要 提供 具体 的 时 间 长 度 、 回 调 函 数 和 参数 。 内 核 会 在 时 间 到 达 时 调用 回调 参数 。 该 定时 器 应 该 由 用 户 提供 并 初始 化 ， 用 户 定时 器 守护 
线程 会 具体 处 理 回调 函数 。 用 户 回调 型 定时 器 支持 两 种 模式 : 一 次 性 的 回调 定时 器 和 无 限 次 的 回调 定时 器 。 


9.2.1 ”软件 定时 器 结构 








Trochili RTOS 中 的 定时 器 结构 定义 在 timer.h 中 ， 具体 结构 如 代码 清单 9-1 所 示 。 


代码 清单 9-1: 内 核定 时 器 结构 定义 





二 

内 核定 时 器 结构 定义 */ 

2 struct TimerDef 

3 { 

4 TTimerID Tigd; 


定时 器 编号 A 

$s TTimerStatus Status; 

定时 器 状态 #y 

6 TTimerType Type; 

定时 器 类 型 */ 

了 TTimerTick RemainTicks; 
扯 

当前 定时 器 延 时 计数 4 

8. TTimerTick BaseTicks; 
/* 

定时 器 延 时 计数 ws 

9. struct ThreadDef* Thread; 
/* 

定时 器 所 属 线程 Wd 

了 和 #if (TCL USER TIMER ENABLE) 

1 TTimerRoutine Routine; 
/* 

用 户 定时 器 回调 函数 x 

1 


TTimerData Data; 





/* 
用 户 定时 器 回调 函数 参数 wy 
二 3。 #endif 

14. TLinkNode LinkNode; 


. 
和 器 所 在 队列 的 链表 节点 本 
: }; 





“Tid 定时 器 ID: 定时 器 的 编号 ID， 在 定时 器 初始 化 时 ， 内 核 自动 为 每 个 定时 器 分 配 一 个 ID。 
“Status 软 件 定时 器 状态 : 即 休 眠 、 活 动 和 期 满 三 种 状态 。 下 节 会 详细 介绍 这 三 种 状态 和 状态 迁移 。 


:Type 定时 器 类 型 : 即 线程 定时 器 、IPC 定 时 器 和 用 户 定时 器 〈 包 括 单 次 回调 和 重复 回调 两 种 ) 三 种 类 型 。 其 中 线程 定时 器 用 来 实现 线程 的 延 时 ; IPC 定 时 器 用 来 完成 线程 对 IPC 资 源 的 时 限 访问 ; 用 户 
定时 器 则 用 来 执行 用 户 注 册 的 回调 函数 。 


前 两 种 软件 定时 器 属于 线程 控制 结构 ， 在 时 钟 节拍 ISR 中 会 直接 处 理 这 两 种 软件 定时 器 。 用 户 定时 器 则 是 由 用 户 提供 定时 器 结构 ， 并 且 它 的 处 理 分 为 两 部 分 : 计时 部 分 在 时 钟 节拍 ISR 中 负责 ， 而 用 户 注 
册 的 回调 函数 则 在 内 核 内 置 的 用 户 定时 器 守护 线程 中 执行 。 


' Thread 定时 器 所 属 线程 : 在 目前 的 内 核实 现 中 ， 每 个 定时 器 都 有 一 个 指向 它 所 在 线程 的 指针 ， 用 来 在 定时 器 操作 中 访问 相应 的 线程 。 

“ RemainTicks 定 时 器 计数 : 在 内 核 时 钟 滴答 ISR 中 处 理 处 于 定时 器 差分 队列 头 的 定时 器 的 计数 ， 该 变量 数值 递减 ， 当 计数 到 达 0 时 ， 说 明定 时 器 到 期 。 
“ BaseTicks 定 时 器 的 计数 备份 : 定时 器 默认 初始 化 的 时 候 被 设置 成 TTMER_DFT_TICKS。 只 用 于 用 户 多 次 回调 类 型 的 用 户 定时 器 。 

“ Routine 用 户 定 时 器 回调 函数 : 该 函数 被 用 户 定时 器 守护 线程 执行 。 

: Data 用 户 定时 器 回调 函数 参数 : 传 给 用 户 回调 定 时 器 函数 使 用 。 


“ LinkNode 定 时 器 链表 节点 : 根据 定时 器 状态 的 不 同 ， 定 时 器 会 被 放 在 不 同 的 队列 中 。 当 处 于 休眠 和 期 满 状 态 时 ， 其 所 处 队列 为 普通 双向 链表 ; 而 当 定 时 器 状态 为 活动 时 ， 其 所 处 队列 为 差分 计时 队 
列 。 这 两 种 类 型 的 链表 都 是 通过 LinkNode 组 织 在 一 起 的 。 


9.2.2 ”软件 定时 器 状态 





软件 定时 器 按照 状态 分 别 组 织 在 不 同 的 定时 器 队列 中 。 上 面 我 们 介绍 过 ， 软 件 定时 器 主要 包括 休眠 、 活 动 和 期 满 三 种 状态 ， 图 9-4 演 示 了 定时 器 在 三 种 状态 间 的 迁移 。 














6 用 户 定 时 如 回调 函数 结束 


i 4 用 户 定时 器 到 其 
5 用 户 定时 器 回调 函数 结束 













、 1 nm 


1 定时 器 初始 化 2 定时 器 启动 


3 线程 定时 器 到 期 
IPC 定时 各 到 期 
定时 带 停 止 


9-4 定时 器 状态 迁移 


























四 在 初始 化 线程 时 首先 对 线程 定时 器 做 简单 初始 化 ， 随 后 将 线程 定时 器 加 入 内 核 的 休眠 定时 器 队列 中 ， 此 时 定时 器 状态 为 休眠 。 


回 当 线 程 需要 延 时 或 者 需要 以 时 限 方式 阻塞 在 IPC 的 线程 阻塞 队列 中 时 ， 内 核 会 重新 设置 线程 定时 器 的 状态 ， 重 新 设置 定时 计数 ， 然 后 把 定时 器 加 入 内 核 活动 定时 器 队列 中 ， 此 时 定时 器 状态 为 活动 。 内 
核 会 在 时 间 节 拍 中 断 中 处 理 内 核 活动 定时 器 队列 。 


国 如 果 定 时 器 在 计数 结束 之 前 停止 (STOP) ， 则 定时 器 返回 休眠 状态 并 加 入 休眠 定时 器 队列 ; 作为 IPC 时 限定 时 器 和 线程 延 时 定时 器 ， 在 定时 器 计数 结束 后 ， 也 会 返回 定时 器 休眠 队列 
图 而 作为 用 户 定时 器 ， 如 果 定 时 结束 ， 则 会 被 放 入 定时 器 期 满 队 列 ， 随 后 内 核 会 唤醒 用 户 定时 器 守护 线程 来 代理 执行 这 些 定时 器 的 回调 函数 。 
回 用 户 定时 器 回调 函数 被 执行 后 ， 如 果 相 应 的 定时 器 是 周期 定时 器 ， 则 该 定时 器 会 被 放 回 活 动 定时 器 队列 ， 进 行 下 一 轮 计时 。 


人 @@ 用 户 定时 器 回调 函数 被 执行 后 ， 如 果 相 应 的 定时 器 是 单 次 定时 器 ， 则 该 定时 器 会 被 放 回 休眠 定时 器 队列 。 如 果 期 满 的 定时 器 在 被 用 户 定时 器 守护 线程 处 理 之 前 被 停止 则 会 被 放 入 内 核 休眠 定时 器 队 
列 ， 并 且 返 回 休眠 状态 。 


9.2.3 ”软件 定时 器 队列 





内 核 维护 了 一 个 定时 器 队列 ， 集 中 管理 全 部 定时 器 。 该 定时 器 队列 又 根据 定时 器 不 同 的 状态 细 分 成 三 个 定时 器 的 分 队列 。 内 核定 时 器 队列 结构 定义 如 代码 清单 9-2 所 示 。 


代码 清单 9-2: 内 核定 时 器 队列 结构 定义 





了 

内 核定 时 器 队列 结构 定义 */ 

2. struct TimerListDef 

3。 { 

4. TLinkNode* DormantHandle; 

5s TLinkNode* ActiveHandle ; 

6 #if (TCL USER TIMER ENABLE) 

y TLinkNode* ExpiredPingHandle; 
TLinkNode* ExpiredPongHandle; 
9. TLinkNode** ExpiredIindicator; 
0s #endif 

1 jy 

12: typedef struct TimerListDef TTimerList; 





“ 休眠 定时 器 队列 : 所 有 定时 器 在 初始 化 之 后 即 进入 此 队列 ， 相 应 的 定时 器 状态 为 休眠 态 。 处 于 活动 态 或 者 期 满 态 的 定时 器 被 内 核 处 理 之 后 也 会 返回 此 队列 。 
“ 活动 定时 器 队列 : 处 于 此 队列 的 定时 器 已 经 开始 计时 ， 此 队列 为 差分 计时 队列 。 


“ 期 满 定时 器 队列 : 只 有 用 户 定时 器 才 会 进入 此 队列 。 当 内 核 检 测 到 该 队列 不 为 空 时 ， 立 刻 激活 用 户 定时 器 守护 线程 。 注 意 在 实现 时 ， 该 队列 存在 两 个 实例 ， 组 成 Ping-Pong 队 列 。 当 其 中 一 个 队列 被 用 
户 定 时 器 守护 线程 处 理 时 ， 另 一 个 就 会 被 时 间 节 拍 ISR 来 保存 新 的 到 期 的 用 户 定时 器 。 用 户 定 时 器 守护 线程 一 旦 启动 ， 则 不 停 地 查询 当前 定时 器 期 满 队列 是 否 为 空 ， 如 果 不 为 空 则 启动 PingPong 处 理 ， 切 换 两 
个 定时 器 到 期 队列 ， 直 到 当前 期 满 定 时 器 队列 为 空 时 才 会 把 自己 休眠 。 成 员 ExpiredIndicator 说 明了 当前 哪个 期 满 定时 器 分 队列 正在 被 用 户 定时 器 守护 线程 处 理 。 


图 9- 5 演示 了 系统 某 时 刻 内核 中 软件 定时 器 队列 的 情况 。 








<--> 





图 9-5 定时 器 队列 快照 





从 图 9-5 中 可 以 看 出 : 


“当前 活动 定时 器 队列 里 有 4 个 定时 器 正在 等 待 计数 处 理 ， 它 们 已 经 按照 差分 队列 排队 。 这 几 个 定时 器 的 用 途 未 必 相 同 。 


“当前 期 满 定 时 器 队列 里 有 2 个 定时 器 已 经 期 满 ， 即 将 被 用 户 定时 器 守护 线程 调用 回调 函数 。 这 两 个 定时 器 肯定 是 用 户 定时 器 。 


9.2.4 ”软件 定时 器 功能 





软件 定时 器 模块 为 其 他 模块 提供 了 定时 功能 ， 另 外 针对 用 户 回调 类 型 的 定时 器 也 提供 了 相关 API 函 数 。 下 面 分 别 介绍 。 
1. 定时 器 操作 函数 


与 软件 定时 器 模块 相关 的 内 部 函数 见 表 9-2。 


表 9-2 ”定时 器 功能 函数 


功能 


1 初始 化 指定 的 定时 器 

2 让 动 指定 的 定时 

3 上 指定 的 定时 

4 重新 设置 定时 器 定时 参数 

5 定时 器 中 断 处 理 函 数 ， 处 理 定时 器 计数 

6 定时 器 分 发 处 理 ， 分 发 定时 器 到 各 队列 

7 定时 器 守护 线程 函数 ， 处 理 期 满 的 用 户 定时 器 
8 执行 期 满 的 用 户 定时 器 回调 函数 


“ 定时 器 初始 化 函数 : 将 尚未 初始 化 的 定时 器 加 入 休眠 定时 器 队列 中 ， 同 时 更 新 定时 器 状态 为 休眠 态 。 线 程 定时 器 和 IPC 时 限定 时 器 是 在 内 核 代码 中 自动 完成 的 ， 不 需要 用 户 参与 初始 化 ; 用 户 回调 定时 
器 则 需要 用 户 显 式 调用 API 函 数 。 


“ 定时 器 启动 函数 : 主要 操作 就 是 将 定时 器 从 休眠 定时 器 队列 中 移 到 活动 定时 器 队列 中 ， 同 时 更 新 定时 器 状态 为 活动 态 。 只 有 用 户 回 调 定时 器 才 需 要 用 户 显 式 调用 相关 API。 
“ 定时 器 停止 函数 : 主要 操作 是 将 定时 器 从 活动 定时 器 队列 中 移 到 休眠 定时 器 队列 中 ， 同 时 更 新 定时 器 状态 为 休眠 态 。 只 有 用 户 回调 定时 器 才 需 要 用 户 显 式 调用 相关 API。 
“ 定时 器 取消 初始 化 函数 : 重新 设置 定时 器 类 型 和 需要 延 时 的 时 间 。 需 要 配合 定时 器 启动 来 使 用 。 线 程 定时 器 和 IPC 时 限定 时 器 是 在 内 核 代码 中 自动 完成 的 ， 用 户 回调 定时 器 也 不 需要 这 个 功能 。 


“ 定时 器 中 断 处 理 函 数 : 这 部 分 主要 完成 活动 定时 器 队列 的 处 理 。 兄 数 首先 将 活动 定时 器 队列 头 的 定时 器 计数 减 1， 完 成 差分 定时 器 队列 的 计数 操作 ; 然后 将 活动 定时 器 队列 中 所 有 的 计时 结束 的 定时 器 
交 由 定时 器 分 发 处 理 函 数 来 操作 。 


“ 定时 器 分 发 处 理 函 数 : 本 函数 根据 定时 器 的 类 型 ， 将 计时 结束 的 定时 器 放 回 休眠 队列 (同时 完成 线程 相关 延 时 操作 ) ， 或 者 放 入 用 户 定时 器 期 满 队列 。 如 果 需 要 ， 本 函数 会 唤醒 用 户 定时 器 守护 线 


“ 定时 器 守护 线程 函数 : 本 函数 用 来 代理 执行 那些 期 满 用 户 定时 器 的 回调 函数 。 所 有 的 到 期 定时 器 的 回调 操作 都 完成 后 ， 本 函 数 将 用 户 定时 器 守护 线程 休眠 。 具 体 回调 函数 的 执行 由 下 面 的 函数 完成 。 
本 元 数 只 负责 处 理 期 满 定时 器 队列 。 


“ 定时 器 回调 处 理 函 数 : 本 函数 处 理 定时 器 的 回调 函数 ， 然 后 根据 定时 器 类 型 〈 单 次 回调 或 多 次 回调 ) 将 定时 器 放 回 定时 器 休眠 队列 或 者 活动 队列 。 


定时 器 中 断 1SR 中 首先 需要 处 理 的 是 定时 器 计数 问题 ， 它 会 检查 内 核 活 动 定时 器 队列 ， 将 队列 头 的 定时 器 计数 减 1， 然 后 尝试 将 所 有 计数 为 0 的 定时 器 从 该 队列 中 移出 ， 并 调用 定时 器 分 发 处 理 函 数 来 处 理 
这 些 定时 器 : 线程 延 时 定时 器 和 IPC 时 限 等 待定 时 器 会 被 放 回 到 内 核 休 眼 定时 器 队列 ;用 户 回调 定时 器 则 需要 放 入 用 户 定时 器 期 满 队列 。 























需要 注意 的 是 ， 根 据 定时 器 类 型 的 不 同 ， 在 唤醒 线程 时 需要 对 相关 的 线程 做 不 同 的 处 理 。 比 如 以 时 限 等 待 方式 访问 资源 的 线程 ， 当 它 的 定时 器 计数 结束 时 ， 表 明 在 指定 的 时 间 内 它 并 没有 获得 资源 ， 所 
以 定时 器 处 理 函数 需要 设置 该 线程 的 资源 访问 结果 为 时 限 结束 并 解除 该 线程 的 阻塞 ;而 线程 延 时 线程 使 用 的 定时 器 则 只 需要 直接 唤醒 该 线程 ， 并 不 需要 其 他 操作 。 总 结 一 下 : 线程 定时 器 和 IPC 时 限定 时 器 的 





时 间 处 理 是 直接 在 ISR 中 完成 的 ， 而 出 于 对 性 能 的 考虑 ， 用 户 回调 定时 器 的 回调 函数 是 在 特殊 的 线程 中 处 理 的 。 








软件 定时 器 相关 的 API 函 数 见 表 9-3。 


表 9-3 用 户 定时 器 功能 函数 


1 初始 化 指定 的 用 户 定时 器 
2 启动 指定 的 用 户 定时 器 
3 停止 指定 的 用 户 定时 器 


2 活动 定时 器 队列 处 理 函 数 


活动 定时 器 队列 处 理 函 数 主要 完成 定时 器 计数 的 维护 。 它 会 将 所 有 计数 为 0 的 定时 器 处 理 ， 如 果 需 要 还 会 激活 用 户 定时 器 守护 线程 。 其 流程 图 如 图 9-6 所 示 。 







2 内 核 进 入 独占 区 
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器 队列 头 为 空 ? 












9 重新 获得 活动 定时 器 队列 
头 的 定时 器 





4 获得 处 于 队 
列 头 的 定时 器 


5 定时 融 计 数 减 1 


6 定时 需 计 数 为 0? 
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13 内 核 退 出 独占 区 





11 期 满 定时 器 队列 为 空 ? 

















图 9-6 ”定时 器 活动 队列 处 理 函 数 流程 

















流程 图 分 析 : 
STEP2 内核 进入 独占 区 ， 需 要 临时 关闭 中 断 。 


STEP3 查看 定时 器 活动 队列 是 否 为 空 。 


STEP4 ”如果 不 为 空 ， 则 获得 队列 头 的 活动 定时 器 。 

STEP5 将 该 定时 器 的 计数 减 1， 完 成 定时 器 差分 队列 的 计数 。 

STEP6 判断 该 定时 器 此 时 的 计数 是 否 为 0。 

STEP7 如 果 计 数 是 9， 说 明 此 定时 器 定时 结束 ， 需 要 调用 定时 器 分 发 处 理 函 数 处 理 该 定时 器 。 

STEP8 再 次 查看 定时 器 活动 队列 是 否 为 空 。 

STEP9 如 果 不 为 空 ， 则 重新 获得 队列 头 的 活动 定时 器 。 

STEP10 判断 该 定时 器 此 时 的 计数 是 否 为 )， 如 果 是 ， 说 明 该 定时 器 也 需要 处 理 ， 所 以 转 到 STEP7。 

STEP11 因为 上 面 步骤 中 可 能 处 理 过 一 个 或 者 多 个 计时 结束 的 定时 器 ， 在 这 些 定时 器 里 又 有 可 能 存在 用 户 定时 器 ， 所 以 在 这 里 需要 检查 用 户 期 满 定时 器 队列 是 否 为 空 。 
STEP12 如 果 存在 用 户 期 满 定 时 器 则 唤醒 定时 器 守护 线程 。 

STEP13 ”代码 退出 独占 区 ， 开 启 中 断 。 


STEP14 ”函数 返回 。 


3 定时 器 分 发 处 理 函数 








定时 器 分 发 处 理 函 数 主要 工作 是 把 计数 为 0 的 期 满 定时 器 按照 定时 器 类 型 区 别处 理 。 用 于 线程 延 时 和 资源 时 限 等 待 的 定时 器 会 在 这 个 函数 中 直接 处 理 。 对 于 用 户 回调 类 型 的 定时 器 则 通过 把 它们 放 入 用 户 
期 满 定时 器 队列 ， 交 由 用 户 定时 器 守护 线程 来 继续 处 理 。 这 个 函数 的 流程 图 如 图 9-7 所 示 。 











3 获得 定时 器 所 属 的 线程 7 获得 定时 才 所 属 的 线程 11 将 该 定时 器 放 和 人 定 


时 需 期 满 队 列 ， 状 态 调 
整 为 期 满 


4 线程 延 时 结束 8 将 该 线程 从 IPC 


阻塞 队列 中 唤醒 


5 定时 器 体 眠 9 定时 顺 体 眠 





否 


图 9-7 定时 器 分 发 处 理 函 数 流程 图 





流程 图 分 析 : 











STEP2 判断 定时 器 类 型 是 否 为 线程 延 时 定时 器 。 
STEP3 如 果 是 ， 则 获得 定时 器 所 属 的 线程 。 
STEP4 ”处 理 该 线程 的 队列 和 状态 ， 到 此 完成 该 线程 的 延 时 。 


STEP5 取消 初始 化 线程 定时 器 为 休眠 态 。 


STEP6 判断 定时 器 类 型 是 否 为 IPC 时 限定 时 器 。 

STEP7 如 果 是 ， 则 获得 该 定时 器 所 属 线程 。 

STEP8 ”处 理 该 线程 的 队列 和 状态 ， 到 此 完成 该 线程 的 时 限 阻塞 。 

STEP9 取消 初始 化 线程 定时 器 为 休眠 态 。 

STEP10 判断 定时 器 类 型 是 否 为 用 户 定时 器 。 

STEP11 如 果 是 ， 则 将 该 定时 器 放 入 用 户 期 满 定时 器 队列 ， 交 给 用 户 定时 器 守护 线程 处 理 。 


STEP12 ”函数 返回 。 


4. 定时 器 守护 线程 


对 于 用 户 回调 型 的 定时 器 ， 内 核 专门 设置 了 一 个 用 户 定时 器 守护 线程 来 处 理 。 平 时 该 线程 是 处 于 休眠 状态 的 ， 一 旦 有 用 户 回调 定时 器 期 满 ， 则 内 核 自动 唤醒 该 线程 。 该 线程 会 逐个 处 理 各 个 期 满 用 户 定 
时 器 ， 直 到 将 所 有 的 定时 器 都 处 理 完 ， 最 后 它 将 自己 休眠 。 


定时 器 守护 线程 函数 首先 将 交换 期 满 定时 器 Ping-Pong 队 列 ， 然 后 调用 期 满 定时 器 处 理 函 数 处 理 交 换 下 来 的 定时 器 期 满 队列 ， 该 队列 被 处 理 结束 后 ， 定 时 器 守护 线程 函数 将 再 次 尝试 交换 期 满 定时 器 
Ping-Pong 队 列 .… 就 这 样 不 停 地 处 理 期 满 定时 器 ， 直 到 所 有 的 期 满 定时 器 都 被 处 理 ， 最 后 该 线程 将 自己 休眠 。 


定时 器 守护 线程 主 函数 流程 图 如 图 9-8 所 示 。 





6 保存 当前 期 满 定时 带 


人 “| 队列 地 址 到 临时 变量 


7 交换 期 满 定时 天 
乒乓 队 绚 





图 9-8 ”定时 器 守护 线程 函数 流程 图 





流程 图 分 析 : 











STEP2 ”处理 定 时 器 期 满 队列 时 需要 关闭 中 断 。 


STEP3 检查 当前 期 满 定时 器 是 否 为 空 ， 判断 是 否 有 期 满 定时 器 需要 处 理 。 


STEP4 如 果 当 前 没有 期 满 定 时 器 需要 处 理 ， 则 定时 器 守护 线程 将 自己 休眠 。 


STEP5 内 核 退 出 独占 区 。 


STEP6 如 果 当 前 有 期 满 定时 器 需要 处 理 ， 则 首先 保存 下 当前 期 满 定时 器 队列 。 


STEP7 交换 Ping-Pong 期 满 定时 器 队列 。 


STEP8 内 核 退 出 独占 区 。 


STEP9 处 理 交 换 下 来 的 期 满 定时 器 队列 。 每 个 期 满 定时 器 都 会 得 到 处 理 。 所 有 期 满 定 时 器 得 到 处 理 后 ， 函 数 尝 试 再 次 得 到 新 的 期 满 定时 器 。 


STEP10 期 满 定时 器 队列 为 空 后 ， 函 数 返 回 。 


5. 用 户 定时 器 回调 处 理 函 数 


























在 处 理 用 户 期 满 定时 器 时 ， 首 先 获得 注册 在 该 类 型 定时 器 上 的 回调 函数 和 回调 参数 ， 然 后 调用 回调 函数 。 最 后 根据 定时 器 类 型 (一 次 型 或 者 重复 型 ) 将 定时 器 放 回 休眠 定时 器 队列 或 者 活动 定时 器 队 
列 。 该 部 分 代码 流程 如 图 9-9 所 示 。 



































图 9-9 ”定时 器 回调 代理 函数 流程 图 


流程 图 分 析 : 
STEP2 如 果 定 时 器 期 满 队列 为 空 ， 那么 直接 退出 。 


STEP3 ”获得 处 于 队列 头 的 线程 ， 调 用 注册 在 它 上 面 的 回调 函数 。 注 意 此 时 并 没有 关闭 中 断 。 


STEP5 将 该 定时 器 从 队列 中 移出 。 出 于 对 周期 回调 类 型 定时 器 的 考虑 ， 这 里 要 恢复 其 定时 计数 。 


STEP6 判断 用 户 定时 器 的 类 型 。 


STEP7 单 次 回调 的 用 户 定时 器 需要 放 回 定时 器 休眠 队列 。 


STEP8 周期 回调 的 用 户 定时 器 需要 放 回 定时 器 活动 队列 。 


STEP9 ”定时 器 处 理 代码 退出 独占 区 。 


STEP10 该 函数 会 轮 询 检查 定时 器 队列 ， 直 到 队列 为 空 ， 函 数 返 回 。 


9.3 ”软件 定时 器 使 用 演示 




















定时 器 用 于 线程 延 时 和 用 于 | 








这 次 我 们 要 实现 的 功能 是 通过 周期 回调 类 型 的 


代码 清单 9-3: 软件 定时 器 示例 











PC 的 时 限 阻塞 功能 在 前 


回 
































各 章 都 已 经 演示 过 了 。 代 码 清单 9-3 演 示 的 是 用 





户 回 


回 











调 类 型 的 定时 器 的 使 有 











户 定时 器 实现 LED1 和 LED2 间 隔 1 秒 点 亮 和 熄灭 ， 开 始 时 LED1 和 LED2 是 点 亮 的 。 


方式 。 





1. #include "example.h" 

2. #include "trochili.h" 

4. #if (EVB EXAMPLE == CH9_ TIMER EXAMPLE) 
Ss 

TN _ 

创建 线程 时 需要 的 参数 */ 

7. #define THREAD LED STACK SIZE (256) 

8. #define THREAD LED PRIORITY {5} 

9. #define THREAD LED SLICE (65535u) 
10 

11. /* LED 


线程 结构 和 栈 */ 


12. static TThread ThreadLED; 


13. static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 


14. 
Po Lt 
用 户 定时 器 结构 */ 


16. static TTimer LedlTimer; 
17. static TTimer Led2Timer; 





2 拉 

22。 static TWord index = 0; 

23. if (index 当 2) 

24. { 

25, EVB_LEDControl (LED1, LED OFF); 
26. } 

21s else 

28 

29.。 EVB_LEDControl (LED1, LED ON); 
30. i 

ls index++7 

32。 } 

33. 

3 

用 户 定时 器 2 


的 回调 函数 ， 间 隔 1 
秒 ， 点 亮 或 熄灭 LED2 */ 


35. static void Blink2 (TTimerData data) 





36. { 

37. static TWord index = 0; 

38.。 if (index 当 2) 

39。 

40 . EVB_LEDControl (LED2, LED OFF); 

41. } 

42. else 

43. { 

44. EVB_LEDControl (LED2, LED ON); 

45. } 

46. indext++; 

47. 1} 

48 . 

A9. /* LED 

线程 主 函数 */ 

50. static void ThreadLEDEntry (void* pArg) 

SL 

352 Vs 

首先 熄灭 三 个 LED 

灯 */ 

S53 EVB_LEDControl (LED1, LED OFF); 

54. EVB_ LEDControl (LED2, LED OFF); 

5 EVB LEDCoNtrol (LED3, LED OFF); 

56. 

357: ys 

初始 化 用 户 定时 器 */ 

58。 TclInitUserTimer (gLedlTimer, eAppPeriodicTimer, 
SY MLS2TICKS (1000), &Blinkl, 0); 
60. TclInitUserTimer (gLed2Timer, eAppPeriodicTimer, 
61. MLS2TICKS (1000), &Blink2, 0); 


62. 
63. We 
启动 用 户 定时 器 */ 
64. 


TclStartUserTimer (&LedlTimer); 
65. TclStartUserTimer (&Led2Timer); 


66. 

67. while (eTrue) 
68. { 

69. } 

了 ge .} 

71. 

1 

汪汪 

用 户 应 用 入 口 函 数 */ 


74. static void APP LEDEntry (void) 


725. 和 


76 . 
配置 使 能 评估 板 上 的 LED 
设备 */ 


17 EVB_LEDConfig(); 
78. 


79. 
初始 化 LED 


四 


设备 控制 线程 */ 
80 . TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)0, 








81. ThreadLEDStack, THREAD LED STACK SIZE, 
82 THREAD LED PRIORITY, THREAD LED SLICE); 
83. 

84. 过 

激活 LED 

设备 控制 线程 */ 

Ys TclActivateThread (&ThreadLED); 

86. } 

7 

,Ey 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

89. int main (void) 

S90. 1 

91, J 

注册 处 理 器 初始 化 函数 到 内 核 */ 

92, TclSetCpuEntry (&uCpuInit); 

93。 

94 . Ve 

注册 板 级 初始 化 函数 到 内 核 */ 

95 . TclSetBoardEntry (&EVB_SetupBoard); 
96. 

97。 

注册 板 级 调试 打印 函数 到 内 核 */ 

98 . TclSetTraceRoutine (&EVB UartlWritestr); 
9 

100. Fi 

注册 用 户 初始 化 函数 到 内 核 */ 

L001. TclSetUserEntry (&APP LEDENtry); 
102. 

i103 We 

启动 内 核 */ 

104. TclStartKernel (); 

105. 

106. return 1; 

107. } 

108. 

109. #endif 





该 程序 运行 情况 演示 如 图 9-10 所 示 。 
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9-10 用 户 回调 类 型 定时 器 演示 








第 10 章 “内核 移植 


RTOS 的 移植 是 一 个 非常 绩 密 的 工作 ， 需 要 开发 者 正确 理解 和 配置 处 理 器 的 各 个 细节 ， 是 和 处 理 器 和 编译 器 特性 紧密 相关 的 。 主 要 包括 处 理 器 的 运行 模式 ， 处 理 器 的 中 断 方式 和 中 断 灌 套 等 。Trochili 
RIOS 大 部 分 的 代码 是 用 C 语 言 写 的 ， 这 有 利于 移植 工作 。 出 于 对 性 能 的 追求 和 C 语 言 的 不 足 ， 只 有 少量 内 核 代码 需要 用 汇编 语言 来 实现 。 


本 章 将 详细 介绍 如 何 将 Trochili RTOS 移 植 到 ARM Cortex M3 处 理 器 上 。 采 用 的 SoC 是 意 法 半导体 的 STM32F107 系 列 处 理 器 。 


10.1 处理 器 介绍 














STM32 系 列 是 意 法 半导体 公司 (ST) 针对 高 性 能 、 低 成 本 、 低 功 耗 的 说 入 式 应 用 而 专门 设计 的 ARM Cortex-M3 吝 入 式 处 理 器 ， 其 产品 系列 非常 丰富 。STM32 处 理 器 示意 








出 


如 图 9-1 所 示 。 









































图 (图 








图 10-1 STM32 处 理 器 示意 
其 中 STM32 F1 系 列 主 流 MCU 满 足 了 工业 、 医 疗 和 消费 类 市 场 的 各 种 应 用 
实现 了 高 集成 度 。 该 系列 包含 五 个 产品 线 ， 它 们 的 引 脚 、 外 设 和 软件 均 兼 容 。 





片 来 自 意 法 半 寻 体 官方 网 站 ) 





需求 。 该 系列 利用 





一 流 的 
: 超 值 型 STM32F100-24 MHz CPU， 具 有 电机 控制 和 CEC 功 能 。 


外 设 和 低 功 耗 、 低 压 操作 实现 了 高 性 能 ， 同 时 还 以 可 接受 的 价格 、 利 用 
: 基本 型 STM32F101-36 MHz CPU， 具 有 高 达 1MB 的 Flash。 





.USB 基 本 型 STM32F102-48 MHz CPU， 具 有 USB 全 速 设备 功能 。 


“ 增强 型 STM32F103-72 MHz CPU， 具 有 高 达 1MB 的 Flash、 电 机 控制 、USB 和 CAN 





“ 互联 型 STM32F105/107-72 MHz CPU， 具 有 以 太 网 MAC、CAN 和 USB 2.0 OTG。 


并 且 STM32F107xx 支 持 以 太 网 。 





由 由 


STM32F105xx 和 STM32F107xx 互 联 型 产品 系列 的 工作 温度 范围 是 -40~+105°C， 供 











电 电 压 为 2.0~3.6V。 为 低 功 耗 应 
STM32F105xx 和 STM32F107xx 互 联 型 产品 系列 提供 从 64 引 脚 至 100 引 脚 ， 共 3 种 不 同 




















设计 提供 了 一 组 完整 的 节 电 模 式 。 

的 封装 选项 。 不 同 的 型 号 ， 包 含 的 外 设 组 合 也 不 同 。 

这 些 特 性 让 STM32F105xx 和 STM32F107xx 互 联 型 微 控制 器 产品 系列 成 为 各 种 应 用 的 理想 之 选 ， 例 如 电机 驱动 和 应 用 
统 、 视 频 电话 、HVAC 和 家 庭 音响 设备 。 





控制 、 医疗 和 手持 式 设备 、 工 业 应 用 





下 面 章节 我 们 将 仔细 介绍 处 理 器 的 开发 细节 。 这 些 内 容 是 我 们 一 直 Trochili 操 作 系统 的 基础 。 


PLC、 逆 变 器 、 打 印 机 、 扫 描 仪 、 


简单 的 架构 和 简便 易 用 


其 中 STM32F105xx 和 STM32F107xx 互 联 型 产品 系列 整合 了 工作 频率 为 72MHz 的 高 性 能 ARM Cortex-M332 位 RISC 内 核 、 高 速 嵌入 式 存 储 器 (256KB Flash 存 储 器 和 64KB SRAM) ， 和 大 量 连 至 2 条 
APB 总 线 的 增强 型 /O 与 外 设 。 所 有 器 件 均 带 有 2 个 12 位 ADC、4 个 通用 16 位 定时 器 和 1 个 PWM 定时 器 ， 以 及 标准 与 高 级 通信 接 


口 : 2 个 1 2C、3 个 SPI、2 个 1 2S、5 个 USART、1 个 全 速 USB OTG 和 2 个 CAN。 


民 


警报 系 





的 工具 





10.1.1 STM32 的 地 址 映射 











Cortex-M3 有 32 根 地 址 线 ， 寻 址 空间 大 小 为 4GB。ARM 公 司 预先 把 这 4GB 的 寻 址 空间 进行 分 配 。M3 存 储 器 映射 见 图 10-2。 





0 x FFFFFFFF 
MB System Level 包括 NVIC 寄存 带 、MPU 
寄存 需 以 及 片上 调试 组 件 


0 x 上 0000000 
0 x DFFFFFFF 


主要 用 于 扩展 片 外 的 外 设 
1GB External Device ( 像 8051 配 8255 似 的 ) 


0 x A0000000 


0 x 9FFFFFFF 
用 于 扩展 外 部 存储 器 


1GB External RAM 由 臣 片 生 产 厂 


商 进 行 具 体 的 
ee 寄存 器 地 址 的 
0 x SFFFFFFF : 映射 
512MB Peripherals 
0 x 40000000 用 于 片上 外 设 
0 x 3FFFFFFF i 
RAM 瑟 此 区 大 


0 x 1FFFFFFF 代码 区 。 也 可 用 于 存储 
0 x 00000000 动 后 缺 省 的 中 断 问 量 表 


图 10-2 CM3 寻 址 空间 映射 





Cortex-M3 分 配给 片上 外 设 的 地 址 范围 是 0x4000 0000 至 0x5FFF FFFF， 共 512MB 空 间 ，0x40000000 称 为 外 设 基地 址 。 





STM32 的 所 有 外 设 都 是 挂 载 在 各 种 总 线 上 的 ， 见 图 10-3。STM32 芯 片 有 AHB 总 线 、APB2 总 线 、APB1 总 线 ， 挂 载 在 这 些 总 线 上 的 外 设 有 特定 的 地 址 范围 。 
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图 10-3 STM32 互 联 型 产品 系统 框图 








10.1.2 ”STM32 的 时 钟 系统 
STM32 芯 片 为 了 实现 低 功 耗 ， 设 计 了 一 个 功能 完善 但 却 复杂 的 时 钟 系统 。 


时 钟 树 & 时 钟 源 





首先 ， 从 整体 上 了 解 STM32 的 时 钟 系统 ， 见 图 10-4。 


























STM32 的 时 钟 分 为 高 速 时 钟 和 低速 时 钟 。 高 速 时 钟 是 芯片 的 主 时 钟 ， 而 低速 时 钟 是 提供 给 芯片 中 的 RTC 及 独立 看 门 狗 使 用 。STM32 的 时 钟 还 可 以 分 为 内 部 时 钟 与 外 部 时 钟 。 内 部 时 钟 是 由 芯片 内 部 RC 
振荡 器 产生 的 ， 特 点 是 起 振 快 ; 而 外 部 时 钟 是 由 外 部 晶振 输入 的 ， 比 内 部 时 钟 更 精度 和 稳定 。 在 芯片 上 电 的 时 候 ， 默 认 使 用 内 部 高 速 时 钟 ， 系 统 启动 之 后 用 户 可 以 通过 软件 来 选择 使 用 外 部 时 钟 。 


48 MHz USBCLK 
至 USB 接口 


ww DS3CLK 


I2S3 
外 设 时 钟 使 能 Pe Is? 


外 设 时 钟 使 能 
ia HSI 外 设 时 钟 使 能 


外 设 时 钟 使 能 
最 大 72MHz 至 AHB 总 线 、 核 心 
外 设 时 钟 使 鹏 > 存储 器 和 DMA 
至 Cortex 系统 时 钟 
FCLK Cortex 自由 运行 时 钟 


| 最 大 36MH3、PCLKI1 
预 分 频 器 几 ， 
5 BD 


,4, 8, 16 至 APB1 外 设 

外 设 时 钟 使 能 | 
如 果 APB1 预 分 频 系数 = 至 定时 咀 2-7 
由 频率 不 变 , 否则 频率 x2 TIMXCLK 

外 设 时 钟 使 能 
最 大 72MHzr_PCIK2 
D APB2 外 设 

外 设 时 钟 使 能 
如 果 APB2 预 分 频 系 数 =1 各 过 包 侣 1 和 8 
则 频率 不 变 , 否则 频率 x2 TIMXCIL 

外 设 时 钟 使 能 


OsC32 IN[L HLSE OSC a Ere 至 ADC1、2 或 3 
| 32, 768 RTCCLK 站, 4, 6, 8 | ADCCLK 最 大 14MHz 
OsC32 OUT[ kHz 


HCLK/2 
2 
Was 四 : 至 SDIO 的 AHB 接口 
ISTEC LSI 至 独立 看 门 狗 (IWDG) 外 设 时 钟 使 能 


40 kHz IWDGCLK 


PLLCLK 图 例 : 
主 时 钟 输出 | HSI HSE = 高速 外 部 时 钟 信号 
OL HSI= 高 速 内 部 时 钟 信号 
HSE LSI= 低速 内 部 时 钟 信号 
SYSCLK LSE = 低速 外 部 时 钟 信号 


all4752d 





图 10-4 ”STM32 时 钟 树 


综 上 所 述 ，STM32 共 有 以 下 4 个 时 钟 源 : 

“ 高 速 外 部 时 钟 (HSE) : 外 部 晶振 提供 的 时 钟 源 ， 晶 振 频率 可 取 范 围 为 4~16MHz， 大 多 采用 8MHz 的 晶振 。 

“ 高 速 内 部 时 钟 (HSI) : 由 内 部 RC 振荡 器 产生 ， 频 率 为 8MHz， 不 够 稳定 。 

“ 低速 外 部 时 钟 (LSE) : 外 部 晶振 提供 的 时 钟 源 ， 主 要 提供 给 实时 时 钟 模块 ， 所 以 一 般 采 用 32.768kHz。 

“ 低速 内 部 时 钟 (LSI) : 由 内 部 RC 振荡 器 产生 ， 也 主要 提供 给 实时 时 钟 模块 ， 频 率 大 约 为 40kHz。 

从 上 面 的 时 钟 树 可 以 看 到 几 个 与 开发 密切 相关 的 时 钟 。 

“ SYSCLK: 系统 时 钟 是 大 部 分 模块 的 时 钟 来 源 。 经 AHB 预 分 频 器 分 配 到 各 个 部 件 。 

* HCLK: 高 速 总 线 AHB 时 钟 主要 提供 给 存储 器 ，DMA 及 CM3 内 核 ， 是 CM3 内 核 运行 的 时 钟 。 由 AHB 预 分 频 器 输出 得 到 。 

“ FCLK: 同样 由 AHB 预 分 频 器 输出 得 到 。 在 HCL 区 时 钟 停止 时 FCLK 仍 然 继续 运行 。 它 的 存在 ， 可 以 保证 在 处 理 器 休眠 时 ， 也 能 够 采样 到 中 断 和 跟踪 休眠 事件 。 


“ PCLK1: 外 设 时 钟 ， 由 APB1 预 分 频 器 输出 得 到 ， 最 大 频率 为 36MHz， 提 供给 挂 载 在 APB1 总 线 上 的 外 设 。 


: PCLK2: 外 设 时 钟 ， 由 APB2 预 分 频 器 输出 得 到 ， 最 大 频率 可 为 72MEHz， 提 供给 挂 载 在 APB2 总 线 上 的 外 设 。 


10.1.3 STM32 的 中 断 和 异常 





Cortex 内 核 具 有 强大 的 异常 响应 系统 ， 它 把 打 断 当前 代码 执行 流程 的 事件 分 为 异常 (exception) 和 中 断 (interrupt) ， 编 号 0~ 15 的 称 为 内 核 异常 ， 而 16 以 上 的 则 称 为 外 部 中 断 。CM3 的 所 有 中 断 机 
制 都 由 NVIC 实 现 。Cortex-M3 中 断 向 量 见 表 10-1。 





表 10-1 Cortex-M3 中 断 向 量 


RS RE 
6 ET 


> 


和信 
2 NMI 不 可 屏蔽 中 断 (来 自 外 部 NMI 输入 脚 ) 
8 硬 (hard) fault 所 有 被 除 能 的 fault， 都 将 “上 访 ”成 硬 fault 


E 可 编程 存储 需 管 理 fault，MPU 访问 犯规 以 及 访问 非法 位 置 


可 编程 。 | 总 线 错误 ( 预 取 流 产 (Abort) 或 数据 流产 ) 
6 Si 可 编程 。 | 由 于 程序 错误 导致 的 异常 
Fault 


nn 





7 一 10 保留 N/A 

11 可 编程 系统 服务 调用 

12 可 编程 调试 监视 器 ( 断 点 ， 数 据 观察 点 ， 或 者 是 外 部 调试 请 求 ) 
13 保留 N/A N/A 

14 为 系统 设备 而 设 的 “可 悬挂 请 求 ” (pendable request) 

15 系统 滴答 定时 需 

16 外 中 断 #0 

条 外 中 断 #1 

255 外 中 断 #239 
































而 STM32 对 这 个 表 重 新 进行 了 编排 ， 把 编号 从 -3 至 6 的 中 断 向 量 定义 为 系统 异常 ， 编 号 为 负 的 内 核 异 常 不 能 被 设置 优先 级 ， 如 复位 (Reset) 、 不 可 屏蔽 中 断 (NMI) 、 硬 错误 (Hardfault) 。 从 编号 7 
开始 的 为 外 部 中 断 ， 这 些 中 断 的 优先 级 都 是 可 以 自行 设置 的 。 详 细 的 STM32 中 断 向 量 表 见 表 10-2。 


表 10-2 STM32 互 联 型 产品 中 断 向 量 


优先 | 优先 级 
立 团 
一 一 一 一 加 


保留 ”| x 0000_0000 





一 留 


0 x0000 0004 


y 
2 | 固定 NMI 不 可 屏 蔽 中 渐 0 x 0000 0008 
= 9 让 1 是 一 
RCC 时 钟 安全 系统 (CSS) 连接 到 NMI 向 量 


更 件 失效 (Har ) es 0 x 0000_000C 
| 0 | 可 设置 | 在 俏 管理 Ne 存储 器 管理 0x 0000 0010 
sFault) 项 取 指 失败 ， 存 储 器 访问 失败 0 x 0000 0014 
sageFault) | 未 定义 的 指令 或 非法 状态 0 x 0000_0018 


1 ED 0x0000 001C 

保留 

一 0x0000_002B 

Svcal 通过 SWI 指令 的 系统 服务 调用 0 x 0000_002C 
凋 试 监控 (DebugMonitor) | 调试 监控 只 0 x 0000_0030 
= 上 | 0x 0000_0034 
PendSV 可 挂 起 的 系统 服务 0 x 0000_0038 
_6 | 可 设置 | SysTick 系统 咬 噶 定时 带 0 x 0000_003C 
0 窗口 定时 器 中 断 0x 0000 0040 
1 | s | 可 设置 连 到 EXTI 的 电源 电压 检测 (PVD) 中 断 。” |0x0000_0044 
2 | 9 | 可 设置 | TAMPER 恨 中 断 0 x 0000_0048 


4 可 设置 闪存 全 局 中 断 0 x 0000 0050 
5 可 设置 复位 和 时 钟 控制 (RCC) 中 断 0x 0000 0054 
6 可 设置 EXTI 线 0 中 断 0 x 0000 0058 
. 
8 
9 























可 设置 | EXTI1 EXTI 线 1 中 断 0 x 0000 005C 

可 设置 | EXTID EXTI 线 2 中 断 0 x 0000_0060 

可 设置 | EXTI3 EXTI 线 3 中 断 0 x 0000_0064 
10 可 设置 置 | EXTI4 EXTI 线 4 中断 0 x 0000 0068 
11 | 18 | 可 设置 |DMA1 通道 1 DMA1 通道 1 全 局 中 断 0 x 0000_006C 
12 可 设置 | DMA1 通道 2 DMA1 通道 2 全 局 中 断 0 x 0000 0070 
13 DMA1 通道 3 DMA1 通道 3 全 局 中 断 0 x 0000_0074 
14 可 设置 | DMA1 通道 4 DMA1 通道 4 全 局 中 断 0 x 0000_0078 
15 可 设置 |DMA1 通道 DMA1 通道 5 全 局 中 断 0 x 0000_ 007C 
16 可 设置 | DMA1 通道 6 DMA1 通道 6 全 局 中 断 0x 0000_0080 
17 DMAI1 通道 7 DMA1 通道 7 全 局 中 断 0x 0000 0084 











18 | 25 | 可 设置 | ADC1 2 ADC1 和 ADC2 全 局 中 断 0 x 0000 0088 
19 可 设置 | CAN1_TX CANI1 发 送 中 断 0 x 0000 008C 
20 可 设置 | CAN1_RX0 CAN1 接收 0 中断 0 x 0000_0090 
21 可 设置 | CAN1_RX1 CANI1 接收 1 中 断 0x 0000 0094 
22 可 设置 | CAN _SCE 0 x 0000 0098 








23 | 30 | 可 设置 | EXTI9 5 EXTI 线 [9:5] 中 断 0 x 0000 009C 
24 | 31 | 可 设置 | TIM1_BRK TIMI1 刊 车 中 断 0 x 0000 00A0 
25 可 设置 | TIM1_UP TIMI1 更 新 中 断 0x 0000 00A4 
26 可 设置 | TIM1_TRG_COM TIMI 触发 和 通信 中 断 0 x 0000 00A8 
27 可 设置 | TIM1_CC TIMI 捕获 比较 中 断 0 x 0000_00AC 
28 可 设置 TIM2 全 局 中 断 0x 0000 00B0 
30 可 设置 | TIM4 TIM4 全 局 中 断 0 x 0000_00B8 
31 | 38 LC1 EV PC1 事件 中 断 0 x 0000_00BC 


32 PC1 错误 中 断 0 x 0000 00C0 
34 PC2 错误 中 断 0x 0000 00C8 
35 SPI] 全 局 中 断 0 x 0000_00CC 


36 SPI2 全 局 中 断 0 x 0000 00D0 


7 | 可 设置 0 x 0000_00E0 
可 让 0 x 0000_00E4 
可 让 0 x 0000_00E8 








心 
己 
心 


总 
叫 


四 


所 


0 x 0000_00EC 
一 0x0000 0104 





: 贸 





TIMS 全 局 中 断 0 x 0000 0108 


UART4 全 局 中 新 0x0000 0110 


TIM7 全 局 中 断 0 x 0000 011C 
人 置 | DMA2 通道 1 通道 1 全 局 中 断 0 x 0000 0120 
J 设置 | DMA2 通道 2 通道 2 全 局 中 断 0 x 0000 0124 
通道 3 全 局 中 断 0 x0000 0128 
可 设置 通道 4 全 局 中 断 0 x 0000_012C 


习 
款 
哺 
[0 
吕 
上 -一 
(LD 


已 
色 
问 
wwn 


un 
iD 
‘OO 
到 
Xp 
虹 | 呵 
[en 
名 
问 
w | 上 


马 | 马 
尖 | 二 
呈 | 品 
口 | 口 
pd | 呈 
必 | 长 
一 CN 






刁 
Nm 
> 


xp 


守 
品 


〈 nh 
[ew 
OlIo|Io|Io|Do Ah | 1 cn ds | dh 心 | 上 
IS | 王 oo | ~ \D 1 co QQ | 
乙 
xp 
| 喇 
LD 


nn 
‘OD 
CN 
CN 


60 DMA2 通道 5 DMA2 通道 5 全 局 中 断 | 0 x 0000_0130 
67 全 速 的 USB OTG 全 局 中 断 0 x 0000 014C 


从 表 7-2 可 以 从 STM32 数 据 手册 中 找到 ， 在 启动 文件 startup_stm32f10x_xx.s 中 也 可 以 看 到 代码 是 如 何 支 持 的 。 因 为 不 同型 号 的 STM32 芯 片 ， 中 断 向 量 表 会 稍 有 区 别 。 

















中 断 控制 器 NVIC (Nested Vectored Interrupt Controller) 是 属于 Cortex 内 核 的 器 件 ， 不 可 屏蔽 中 断 (NMI) 和 外 部 中 断 都 由 它 来 处 理 ， 而 SYSTICK 不 是 由 NVIC 来 控制 的 NVIC 框 图 如 图 10-5 所 示 。 














NVIC 








内 部 私有 外 设 总 线 
(AHB ) 


内 部 私有 外 设 总 线 
(APB) 


图 10-5 ”NVIC 框 图 


1. 抢占 优先 级 和 响应 优先 级 




















Cortex-M3 的 中 断 向 量具 有 两 个 属性 ， 一 个 为 抢占 属性 ， 另 一 个 为 响应 属性 ， 其 属性 编号 越 小 ， 表 明 它 的 优先 级 别 越 高 。 
不 同 的 抢占 优先 级 的 中 断 闻 ， 优 先 级 高 的 中 断 可 以 抢占 优先 级 低 的 中 断 ; 抢占 优先 级 相同 的 中 断 间 不 能 抢占 ， 但 当 两 个 中 断 同时 到 达 时 ， 由 响应 优先 级 决定 首先 响应 哪个 中 断 。 


表 10-3 中 断 向 量 举例 


ET NE 
| ; 


假如 内 核 正 在 执行 L1 的 中 断 服务 函数 ， 则 它 能 被 抢占 优先 级 更 高 的 中 断 H 打 断 ， 由 于 L1 和 L0 的 抢占 优先 级 相同 ， 所 以 L1 不 能 被 L0 打 断 。 但 如 果 L1 和 L0 中 断 是 同时 到 达 的 ， 内 核 就 会 首先 响应 响应 优先 级 
别 更 高 的 L0 中 断 。 


2. NVIC 的 优先 级 组 


在 STM32 中 ， 抢占 优 先 级 和 响应 优先 级 的 数量 由 一 个 4 位 的 数字 来 决定 ，NVIC 最 多 可 以 配置 16 种 中 断 向 量 优先 级 。 这 个 4 位 数字 的 位 数 又 可 以 分 配 成 抢占 优先 级 部 分 和 响应 优先 级 部 分 。 这 样 划 分 方式 
分 为 5 组 : 


“ 第 0 组 : 所 有 4 位 用 来 配置 响应 优先 级 。 

“ 第 1 组 : 最 高 1 位 用 来 配置 抢占 优先 级 ， 低 3 位 用 来 配置 响应 优先 级 。 
“ 第 2 组 : 高 2 位 用 来 配置 抢占 优先 级 ， 低 2 位 用 来 配置 响应 优先 级 。 

“ 第 3 组 : 高 3 位 用 来 配置 抢占 优先 级 ， 最 低 1 位 用 来 配置 响应 优先 级 。 


“ 第 4 组 : 所 有 4 位 用 来 配置 抢占 优先 级 。 





以 第 1 组 为 例 ， 在 16 种 中 断 向 量 中 ， 有 8 种 中 断 的 抢占 优先 级 为 0 级 ， 而 它们 的 响应 优先 级 分 别 为 0~7; 其 余 8 种 中 断 向 量 的 抢占 优先 级 则 为 1 级 ， 响 应 优先 级 别 分 别 为 0~ 7。 











要 配置 这 些 优先 级 组 ， 可 以 采用 ST 库 函数 NVIC_PriorityGroupConfig () ， 可 选 的 参数 为 NVIC_PriorityGroup_0~NVIC_PriorityGroup_4， 分 别 对 应 以 上 介绍 的 5 种 分 配 组 。 








在 对 某 个 具体 的 中 断 分 配 优先 级 的 时 候 ， 需 要 指定 它 的 中 断 向 量 种 类 ， 即 从 16 种 中 断 向 量 中 选择 一 个 。 注 意 NVIC 能 配置 的 是 16 种 中 断 向 量 ， 而 不 是 16 个 ， 当 程序 中 有 超过 16 个 中 断 向 量 时 ， 必 然 有 某 
些 中 断 是 使 用 相同 的 中 断 向 量 种 类 ， 具 有 相同 中 断 种 类 的 中 断 向 量 不 能 互相 族 套 (抢占 优先 级 相同 ) 。 























10.1.4 ”时 钟 节拍 定时 器 

















很 多 系统 都 需要 硬件 来 产生 固定 的 时 钟 节拍 ， 特 别 是 那些 基于 RTOS 的 系统 。 时 钟 节拍 这 个 功能 通常 由 硬件 定时 器 来 实现 。 在 CM3 内 核 中 包含 了 一 个 特殊 的 硬件 定时 器 ， 即 SysTick 定 时 器 ， 用 于 
SysTick 异 常 。 所 有 的 CM3 芯 片 都 带 有 这 个 定时 器 ， 这 样 方 便 了 软件 在 不 同 广 商 的 CM3 处 理 器 间 的 移植 工作 。 


谋 





























该 定时 器 的 时 钟 源 可 以 是 内 部 时 钟 (FCLK) ， 或 者 是 外 部 时 钟 (STCLK) 。 因 为 STCLK 的 具体 来 源 由 MCU 设 计 者 决定 ， 因 此 不 同 厂商 的 产品 的 时 钟 频率 可 能 会 不 一 样 。 在 STM32 处 理 器 中 ，SysTick 以 
HCLK (AHB 时 钟 ) 或 HCLK/8 作 为 运行 时 钟 。 











MCO[3:0 i .ee 
BB a HCLK 至 AHB 总 线 、 核 心 存储 顺和 DMA 
HSI /8 至 Cortex 系统 定时 关 
一 一 FCLK Cortex 自由 运行 时 钟 
pTT3CTR/2 APB1 预 分 频 器 | 。 最 大 36MHz BD PCLKI1 
PITSCTRK /1, 2, 4, 8, 16 外 设 时 钟 使 能 APB1 外 设 





如 果 APB1 预 分 频 系数 =1 定时 器 2-7 


SYSCLK | _ [AHB 预 分 闫 器 则 频率 不 变 , 否则 频率 x 2 门 》 





最 大 72MHz /1/2 /512 -一 TIMxCLK 
( 见 注 1) 外 设 时 钟 使 能 
APB2 预 分 频 器 | ”最 大 72MHz PCLK2 
/1 2 机 16 外 设 时 钟 使 能 APB2 外 设 


图 10-6 SysTick 定 时 器 时 钟 源 


SysTick 是 一 个 24 位 的 定时 器 ， 计 数值 被 保存 到 当前 计数 值 寄存 器 STK_VAL 中 ， 向 下 计数 ， 每 隔 1 个 时 钟 脉 冲 就 将 STK_VAL 值 碱 1。 当 减 至 0 时 ， 硬 件 会 触发 异常 ， 同 时 把 重 载 宥 存 器 STK_LOAD 中 的 数据 
加 载 到 STK_VAL， 重 新 计数 。 











SysTick 定 时 器 的 相关 寄存 器 如 图 10-7 所 示 。 











本 一 | 人 1 | 己 | 四 | 寸 | 习 CI 一 | 尼 | 路 11C| 忆 | 由 | 寸 | 只 1 一 
Offset Reglstel lslslsIslslslslsIslslslslslslslelsIelsl=lelsl» Iles InN |- 


STK CTRL 
Reserved 
Reset Value 


~ CLKSOURCE 
TICK INT 
EN ABLE 


SCOUNTFLAG 


© 
© 


STK LOAD RELOAD[23:0] 
Reserved 

Reset Value 

STK VAL 

STK CALIB 


其 中 寄存 器 STK_CTRL 用 来 配置 SysTick 定 时 器 ， 见 表 10-4。 














10-7 SysTick 和 寄存 器 映像 





























表 10-4 Systick CTRL 寄 存 器 


31 30 29 28 27 20 23 24 2 22 2 20 19 18 yl 16 


ULD 





1) ENABLE: SysTick 定 时 器 的 使 能 位 ， 置 1 使 能 SysTick 定 时 器 ， 置 0 关闭 SysTick 定时 器 。 





2) TICKINT: 异常 触发 使 能 位 ， 置 1 时 允许 触发 SysTick 异 常 ， 置 O 时 则 不 触发 异常 。 








3) CLKSOURCE: 时 钟 选择 位 ， 置 1 时 SysTick 定 时 器 的 时 钟 为 AHB 时 钟 ， 置 0 时 SysTick 定 时 器 时 钟 为 AHB/8 (AHB 的 八 分 频 ) 。 


4) COUNTFLAG: 计数 0 标志 位 ， 若 STK_VAL 计 数 至 0， 此 标志 位 会 被 置 1。 


10.1.5 ”处理 器 启动 


在 移植 内 核 时 ， 我 们 首先 比较 关心 处 理 器 的 启动 流程 。 在 ST 提 供 的 库 文件 启动 文件 (3.5 版 ) 中 有 一 段 启 动 代码 ， 见 代码 清单 10-1。 


代码 清单 10-1: STM32 启 动 代码 startup_stm32f10x_cl.s 





1. ;Reset Handler 

子 程序 开始 

2. Reset Handler PROC 
3. 


站 





4。 3 
输出 子 程序 Reset_Handler 
到 外 部 文件 


6. 


EXPORT Reset Handler [WEAK] 


3 六 
从 外 部 文件 中 引入 __main 
函数 


8. IMPORT _ main 
9. 


加 。 3 

从 外 部 文件 引入 SystemInit 
函数 

Ls IMPORT SystemInit 


]3。 六 
把 SystemInit 








函数 调用 地 址 加 载 到 通用 寄存 器 z0 

14. LDR RO, =SystemInit 
15, 

TL6s 

跳 转 到 0 

中 保存 的 地 址 执行 程序 (调用 SystemInit 
函数 ) 

Es BLX RO 

18. 

二 全 

把 main 

函数 调用 地 址 加 载 到 通用 寄存 器 x0 

20。 LDR RO, = main 
21. 加 
2 

跳 转 到 0 

中 保存 的 地 址 执行 程序 〈 调 用 main 
函数 ) 

23。 Bx RO 

24. 

25. ;Reset Handler 

子 程序 结束 

26. ENDP 











当 芯片 复位 或 上 电 的 时 候 ， 会 首先 执行 这 段 程序 。 先 后 调 








Systemlnit () 函数 定义 在 system_stm32f10x.c 文 件 之 中 ， 它 的 作 | 
所 示 。 


代码 清单 10-2: SetSysClock () 代码 


函数 Systemlnit () 和 函数 _main， 最 后 转 到 

















户 文件 中 的 “main” 函 数 入 口 

















， 开 始 运行 



































是 设置 系统 时 钟 SYSCLK。 它 首先 将 与 配置 时 钟 相关 的 寄存 器 都 复位 ， 然 后 调 














函 


户 程序 。 





数 SetSysClock () 来 设置 时 钟 ， 如 代码 清和 


有 10-2 








static void SetSysClock (void) 


{ 

#ifdef SYSCLK FREQ HSE 
SetSysClockToHSE (); 

#elif defined SYSCLK FREQ 24MHz 
SetSysClockTo24 () 7 

#elif defined SYSCLK FREQ 36MHz 
SetSysClockTo36 () 7 

#elif defined SYSCLK FREQ 48MHz 
SetSysClockTo48 (); 

. #elif defined SYSCLK FREQ 56MHz 

SetSysClockTo56 () 7 

。#elif defined SYSCLK FREQ 72MHz 

SetSysClockTo72 () 7 

。#endif 


oo om wh 


18. } 


/* If none of the define above is enabled, the HSI is used as System clock source (default after reset) */ 





从 SetSysClock() 代码 可 以 知道 ， 它 是 通过 宏 来 选择 编译 不 同时 钟 配置 的 ， 如 代码 清单 10-3 所 示 。 


代码 清单 10-3: SYSCLK_FREQ 宏 定义 





11 
HSE VALUE */ 
24000000 


#if defined (STM32F10X LD VL) 
/* #define SYSCLK FREQ HSE 
#define SYSCLK FREQ 24MHz 
#else 
/* #define 
/* #define 
/* #define 
/* #define 
/* #define 
. #define SYSCLK FREQ 72MHz 
. #endif 加 


SYSCLK _FREQ HSE 
SYSCLK_FREQ 24MHz 
SYSCLK_FREQ 36MHz 
SYSCLK FRFQ 48MHz 48000000 */ 
SYSCLK FREQ 56MHz 56000000 */ 
72000000 


HSE VALUE */ 
24000000 */ 
36000000 */ 


FRRoooamwmemwm 


Po* 


(defined STM32F10X MD VL) 


11 (defined STM32F10X HD VL) 





这 里 定义 了 宏 SYSCLK_FREQ_72MHz，SetSysClockTo72 () 函数 就 是 最 底层 的 库 函 数 ， 它 会 


10.2 ”内 核 移植 


我 们 首先 看 一 下 Trochili RTOS 文 件 目录 ， 见 表 10-5。 






































体 配置 和 检查 各 种 底层 寄存 器 。 


表 10-5 RTOS 文 件 列表 


EE 到 
STM32 处 理 器 功能 代码 ， 汇 编 实 现 
\sre\cpu 2 cg 
STM32 处 理 器 功能 代码 ，C 实现 
内 核 启动 和 中 断代 码 
线程 管理 和 调度 实现 代码 
\stc\core 定时 器 功能 实现 代码 
内 核 调试 功能 代码 
各 种 ipc 机 制 的 支持 函数 
\src\core\ipc 互 斥 量 实现 代码 
TI 
消息 队列 实现 代码 
\src\core\daemon kl et 
内 核 timer 线程 实现 
\src\lib 队列 等 数据 结构 支持 函数 
\src\api 内 核 API 实现 代码 
内 核 配置 文件 ， 主 要 是 各 种 宏 定义 
\inc 内 核 数据 类 型 定义 
内 核 头 文件 集合 ， 各 个 模块 的 头 文件 


10.2.1 内 核 功 能 剪裁 


Trochili RTOS 的 文件 目录 结构 是 很 清晰 的 ， 并 且 各 个 文件 很 独立 。 在 上 面 介绍 的 内 核 文 件 列表 中 ， 文 件 tcl.config.h 是 内 核 的 配置 文件 。 在 这 个 文件 中 ， 有 很 多 内 核 功能 的 宏 开 关 ， 通 过 对 这 些 宏 的 配 
置 ， 可 以 对 内 核 功能 做 出 最 合适 的 剪裁 。 内 核 配 置 代码 如 代码 清单 10-4 所 示 。 





代码 清单 10-4: 内 核 配置 代码 





#ifndef _TOCHILI_ CONFIG H 
#define JTOCHILI CONFIG H 


二 
核 时 钟 节拍 配置 ， 硬 件 定时 器 每 秒 中 断 次 数 */ 

#qdefine TCL KERNEL TICKS RATE (100) 
/x 
核 调试 功能 使 能 配置 */ 

#define TCL DEBUG FNABLE 

#define TCL DEBUG KERNEL ENABLE 
10. #define TCL DEBUG THREAD ENABLE 
11. #define TCL DEBUG DAFMON ENABLE 
12. #define TCL DEBUG TIMER ENABLE 
13. #define TCL DEBUG IPC FNABLE 
14. #define TCL DEBUG SEMAPHORE ENABLE 
15. #define TCL DEBUG MUTEX ENABLE 
16. #define TCL DEBUG MAILBOX ENABLE 
17. #define TCL DEBUG MESSAGE ENABLE 
18. #define TCL DEBUG FLAGS FNABLE 
19. #define TCL DEBUG MEMORY ENABLE 
20. #define TCL DEBUG LIB ENABLE 


Re 


Co 


22. 7* 

内 核 断 言 功能 使 能 配置 */ 

23. #define TCL ASSERT ENABLE 

24. #define TCL ASSERT API ENABLE 

25. #define TCL ASSERT KERNEL FNABLE 
26. #define TCL ASSERT THREAD FNABLE 
27. #define TCL ASSERT DAEMON ENABLE 
28. #define TCL ASSERT TIMER ENABLE 
29. #define TCL ASSERT IPC FNABLE 

30. #define TCL ASSERT SEMAPHORE ENABLE 
31. #define TCL ASSERT MUTEX ENABLE 
32. #define TCL ASSERT MAILBOX ENABLE 
33. #define TCL ASSERT MESSAGE ENABLE 
34. #define TCL ASSERT FLAGS ENABLE 
35. #define TCL ASSERT MEMORY ENABLE 
36. #define TCL ASSERT LIB ENABLE 


Ccpcpccpcpcpcpcppcppep 


383| 优 

供 内 核 调 试 和 断言 功能 使 用 的 注释 */ 

39. #define TCL NOTE ENABLE 

40. #define TCL NOTE API ENABLE 

41. #define TCL NOTE KERNEL FNABLE 
42. #define TCL NOTE THREAD ENABLE 
43. #define TCL NOTE DAEMON ENABLE 
44. #define TCL NOTE TIMER ENABLE 

45. #define TCL NOTE IPC ENABLE 

46. #define TCL NOTE SEMAPHORE ENABLE 
47. #define TCL NOTE MUTEX ENABLE 

48. #define TCL NOTE MAILBOX ENABLE 
49. #define TCL NOTE MESSAGE ENABLE 
50. #define TCL NOTE FLAGS ENABLE 
51. #define TCL NOTE MEMORY ENABLE 
52. #define TCL NOTE LIB ENABLE 


II 过 过 过 过 过 过 过 


53 


54. /* 

用 户 线程 优先 级 范围 配置 */ 

55. #define TCL USER THREAD PRIORITY LOW 
56. #define TCL USER THREAD PRIORITY HIGH 
57. 

SB /二 

定时 器 功能 使 能 配置 */ 

59. #define TCL TIMER FNABLE 

60. #define TCL USER TIMER ENABLE 


各 种 ITPC 

功能 使 能 配置 */ 

63. #define TCL IPC FNABLE (1) 
. #define TCL IPC MAILBOX ENABLE (1) 
. #define TCL IPC MO ENABLE (1) 
. #define TCL IPC MUTEX ENABLE (1) 
. #define TCL IPC SEM FNABLE (1) 
. #define TCL IPC FLAGS ENABLE (1) 
. #define TCL IPC TIMER ENABLE (1) 


PEs ds 
内 存 管理 使 能 配置 */ 
72. #define TCL MEMORY ENABLE 


76. #define TCL ISR ENABLE 
7 


18 A/* 
内 核 时 钟 节拍 配置 ， 硬 件 定时 器 每 秒 中 断 次 数 */ 


79。#define TCL TIME TICK RATE (100u) 
80. 

81; /* 

设备 管理 配置 */ 

82. #define TCL DEVICE ENABLE (1) 


83. /* HOOK 

功能 使 能 配置 */ 

. #define TCL HOOKS ENABLE 

. #define TCL IDLE HOOK FNABLE 


. #endif /* TOCHILI CONFIG H */ 














这 些 宏 定义 基本 做 到 了 望 文生 义 ， 








户 可 以 按照 自己 的 需要 配置 剪裁 内 核 功能 。 


10.2.2 ”内 核 移 植 实 现 











文件 tcl.stm32f10x.a.asm 和 tcl.stm32f10x.c 就 是 我 们 在 STM32 处 理 器 上 移植 内 核 的 具体 实现 ， 前 者 是 上 











表 10-6。 
表 10-6 
西数 
uCpuBuildThreadStack 
uCpuApplyThreadSwitch 


uCpuCancelThreadSwitch 


uCpuSwitchThread PendSV 中 断 处 理 函 数 
函数 
uCpuEnterCritical 关闭 处 理 器 中 断 


uCpuLeaveCritical 


uCpuStartSysTick 启动 内 核心 跳 时 钟 
uCpuCalcHiPRIO 计算 最 佳 优先 级 
uCpuInit 处 理 硕 初始 化 


10.2.3 ”线程 栈 初 始 化 函数 











首先 是 线程 栈 的 初始 化 函数 uCpuBuildThreadStack () 
样 就 实现 了 线程 的 第 一 次 调度 运行 。 


。 该 函数 的 作 | 

















代码 清单 10-5: 线程 初始 化 函数 


伪造 线程 中 断 栈 帧 
请 求 触发 PendSV 中 断 


取消 PendSV 中 断 请 求 





打开 处 理 器 中 断 








汇编 实现 的 部 分 功能 ， 后 者 则 是 C 语 言 来 实现 的 。 我 们 来 具体 分 析 这 两 个 文件 中 的 各 个 函数 ， 见 


内 核 移植 相关 函数 


所 在 文件 
tcl.stm32f 10x.c 
tcl.stm32f10x.c 
tcl.stm32f10x.c 


tcl.stm32f 10x.a.asm 


所 在 文件 
tcl.stm32f 10x.a.asm 
tcl.stm32f 10x.a.asm 
tcl.stm32f10x.c 
tcl.stm32f10x.a.asm 


tcl.stm32f10x.c 


是 伪造 一 个 中 断 现 场 ， 把 线程 的 上 下 文 初始 值 保存 到 线程 栈 中， 然后 通过 PendSV 中 断 来 将 这 个 线程 的 上 下 文 恢复 到 处 理 器 ， 这 





已 大 


功能 : 
多 本 们 和 和信 帆 训 始 化 本 


参数 : (1) PBase 
线程 栈 基地 址 

人。 (2) pTop 
线程 栈 顶 地 址 

5 过 (3) PStack 
线程 栈 地 址 

6. 过 (4) size 
线程 栈 大 小 ， 以 4 





字 节 为 单位 


(5) pEntry 








全 函数 地 直 
(6) PData 

全 要 和 
gm: 
1, 吉 

说 明 : 
线程 栈 起 始 地 址 必须 4 
字 节 对 齐 
oh 
12. void uCpuBuildThreadStack (TAddr* pBase, TAddr* pTop, 
13. void* pStack, TWord size, 
14. void* pEntry, void* pData) 
1 
6 TRegister* pTemp; 
TT 
18. *pBase = (TWord)pStack + size; 
19s pTemp = (TRegister*) (*pBase); 
2 
从 计 站 理 时 中 昕 本 现场 在 线程 第 一 次 被 加 载运 行 时 使 用 4 
2 * (pTemp) = (TRegister)O0x01000000U;  /* PSR 
23. *(--pTemp) = (TRegister)pEntry; # 
线程 函数 </ 
24. *(--pTemp) = (TRegister)OxFFFFFFFEU; /* R14 (LR) 
25. *(--pTemp) = (TRegister) 0x12121212U; /* R12 
26. *(--pTemp) = (TRegister) 0x03030303U; /* R33 
演 7 *(--pTemp) = (TRegister) 0x02020202U; /* R2 
28 . *(--pTemp) = (TRegister)O0x01010101U; /* R1 
29. *(--pTemp) = (TRegister)pData; /* 
线 相 有数 二 
六 化 在 外 人 时 不 会 自 动 保存 的 给 上 下 文 ， 

这 个 才 存 吕 数 人 没有 什么 意义 ， 就 算 内 核 的 指纹 吧 */ 
23: *(--pTemp) = (TRegister)O0x00000054; /* R11 ,T 
34. *(--pTemp) = (TRegister) 0x00000052; /* R10 ,R 
二 8 *(--pTemp) = (TRegister)O0x0000004f; /* R9 70 
6 *(--pTemp) = (TRegister)O0x00000043; /* R8 ,C 
Ss *(--pTemp) = (TRegister)O0x00000048; /* R7 ,H 
38。 *(--pTemp) = (TRegister)O0x00000049; /* R6 ,I 
39. *(--pTemp) = (TRegister)O0x0000004c; /* R5 ,L 
40. *(--pTemp) = (TRegister)O0x00000049; /* RA4 ,I 
41. 
42 . *pTop = (TRegister)pTemp; 
43. 1} 


EE 


Ei 
Pm 
2 
222*7 
2 


和 
ty 
ey 
wo 
Re 
i 
ey 





这 个 函数 的 实现 是 和 处 理 器 特性 紧密 相关 的 。 在 Cortex-M3 处 理 器 上 ， 中 上 断 流程 会 自动 保存 部 分 寄存 器 内 容 到 栈 中 ， 而 有 的 寄存 器 则 需 


剩余 的 寄存 器 到 栈 中 。 


10.2.4 PendSV 中 断 管理 函数 


现 的 。 在 某 些 情况 下 ， 


EG: 


四 


























户 决定 如 何 保存 。 在 当前 版 本 的 内 核 中 ， 我 们 需要 保存 全 部 


前 面 的 章节 中 ， 没 有 明确 说 明 内 核 在 Cortex-M3 处 理 器 上 具体 如 何 完成 线程 调度 的 。 其 实在 内 核 中 ， 所 有 线程 的 调度 并 不 是 立刻 完成 的 ， 而 是 通过 函数 uCpuApplyThreadSwitch () 触发 PendSV 来 实 


代码 清单 10-6: uCpuSwitchThread 处 理 函 数 


还 没 被 响应 的 PendSV 中 断 有 可 能 被 系统 通过 函数 uCpuCancelThreadSwitch () 取消 。PendSV 中 断 处 理 函 数 是 uCpuSwitchThread () ， 它 是 线程 调度 的 核心 代码 ， 
然 很 得 ， 但 涉及 的 技术 细节 很 多 。PendSV 中 断 处 理 函 数 实现 和 注解 如 代码 清单 10-6 所 示 。 


这 段 汇编 代码 





1. ;Cortex-M3 
进入 异常 服务 例 程 时 ， 自 动 压 栈 了 RO0-R3, R12, LR (R14, 
连接 寄存 器 ) ,PSR ( 


程序 状态 咨 大 呈 ) 

和 PC (R15). 

Z。 7PSP 

不 自动 压 栈 ， 不 需要 保存 到 栈 中 ， 而 是 保存 到 线程 结构 中 
3。 

4. uCpuSwitchThread 

5s 

6. CPSID 区 

a MRS RO, PSP 

8 CBZ RO, FIRST THREAD ENTER 
9, 

10. $ 

保存 r4-z11 

Ds SUBS RO, RO, #0x20 

12。 STM RO, {R4-R11} 

T3。 

卫生 -及 

保存 ps 

到 线条 信 构 

让 LDR R1, =uThreadCurrent 
16. LDR R1l, [R1] 

1L7s STR RO, [R1,#8] 

TB: 

19. FIRST THREAD ENTER 

20. 

A 

使 得 uThreadCurrent = uThreadNominee; 
32 LDR RO, =uThreadCurrent 
23。 LDR R1, =uThreadNominee 
24. LDR R2, [R1] 

25. STR R2, [RO] 

26. 

es 

根据 uThreadCurrent 

中 取得 SP 

数值 到 RO 

28. LDR RO, [R2,#8] 

29. 

ep 

从 新 线程 栈 中 弹出 r4-11 

1 LDM RO, {R4-R11} 

32. 

33. ;psp 

指向 中 断 自动 压 栈 后 的 栈 顶 

34. ADDS RO, RO, #0x20 

35。 MSR PSP, RO 

36. 

37 . 


上 电 后 ， 处 理 器 处 于 线程 + 
特权 模式 tmsp 


对 于 第 一 次 active 
任务 ， 当 引发 pendsv 
中 断后 ， 


39. ; 
处 理 器 进入 handler 
模式 ， 使 用 msp 


40. ; 





ie 办 各 使用 pep 


中 弹 Em Fonttp: //www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14878/OEBPS/Text/.. 
人 


及 以 需要 修改 IR 
强制 使 用 psp 

42 ORR LR, LR, #0x04 

43. CPSIE I 

有 发 生 中 断 ， 而 此 时 新 的 当前 线程 的 上 下 文 并 没有 完全 恢复 
和 让 的 二 好 相 人 

机 和 动作 部分 才 丰 吕 到 线程 术 中 ， 其 他 宁 丰 器 还 玉 在 人 理 江上 下 文中 


得 而 在 此 时 产生 的 中 断 ISR 
中 调用 那些 


49. ; (1) 
会 将 当前 线程 从 就 绪 队列 中 移出 的 API 








50， > 2) 
人 
讽 和 当前 和 他人 的 优先 级 
区 发 生 时 间 片 轮转 
那么 有 可 导致 一 次 新 的 PensSv 
省 求全 村 十 
当主 和 启动 异 党 返回 流 村， 会 发 生前 后 两 个 PendSV 
咬 尾 中 断 。 
55, ; 
按照 ucM3PendsvVHandler 
的 尝 程 ， 当前 线程 的 上 下 文中 导 此 游离 的 守 在 器 会 
二 将 到 二 栈 中 ， 即 不 继续 
让 也 训 是 说 第 一 次 线程 上 下 文 切换 被 强制 取消 了 ， 转 而 执行 第 二 次 的 
2 上 下 淆 切换 。 


es 
党 于 二 


了 


、 Ir3 

寄存 器 ， 切 换 到 任务 。 

61 . BX LR 

62. ; 

返回 后 ， 处 理 器 使 用 线程 + 
特权 模式 +psp 

出 站 并 入 雹 江 下 二 全。 
64. END 





这 个 函数 需要 关注 以 下 几 个 问题 。 


“ 晚 到 中 断 的 情景 : PendSV 中 断 的 优先 级 被 设置 成 最 低 ， 所 以 从 PendSV 中 断 被 触发 到 响应 再 到 中 断 处 理 的 过 程 中 ， 有 可 能 发 生 其 他 更 高 级 的 中 断 。 那 些 更 高 级 的 中 断 处 理 函 数 具体 做 什么 操作 都 有 可 
能 ， 所 以 可 能 又 不 需要 之 前 的 PendSV 请 求 了 。 


: 中断 襄 套 情景 : 在 第 一 个 中 断 执行 的 时 候 ， 处 理 器 首先 把 部 分 寄存 器 保存 到 用 户 栈 中 ， 即 PSP， 假 如 这 个 中 断 被 第 二 个 更 高 优先 级 中 断 抢占 的 话 ， 那 么 一 些 寄存 器 就 要 自动 保存 在 中 断 栈 中 ， 即 MSP 
中 。 如 果 再 发 生 第 三 个 中 断 ， 那 么 第 三 个 中 断 也 使 用 MSP。 中 断 进入 时 ， 内 核 会 把 中 断 计数 加 1， 在 中 断 退 出 时 ， 内 核 会 把 中 断 计 数 减 1， 然 后 当中 断 计数 为 0 时 ， 内 核 检 查 当 前 线程 是 不 是 最 优 线程 ， 如 果 不 
是 内 核 会 发 出 线程 调度 请 求 ， 即 触发 PendSV 中 断 。 一 旦 PendSV 中 断 执行 ， 它 会 关闭 中 断 ， 此 时 线程 调度 才 真 正 执行 。 


:中断 咬 尾 的 情景 : 如 果 第 三 个 中 断 的 优先 级 又 比 第 一 个 中 断 还 低 ， 因 为 不 能 发 生 识 套 ， 所 以 在 第 一 个 中 断 退 出 时 ， 内 核发 现 中 断 计 数 为 0， 因 此 可 能 会 发 出 PendSV 中 断 请 求 ; 随后 第 三 个 中 断 马 上 会 
咬 尾 操作 ， 然 后 在 第 三 个 中 断 退 出 时 ， 内 核 又 发 现 中 断 计 数 为 0)， 所 以 可 能 会 再 次 发 出 PendSV 中 断 请 求 ， 也 有 可 能 会 取消 线程 调度 。 


上 面 描述 的 几 种 处 理 器 情景 比较 复杂 。 总 的 来 说， 在 PendSV 开 始 执行 之 前 ， 系 统 对 PendSV 的 所 有 申请 并 不 一 定 是 有 效 的 ， 可 能 会 被 取消 。 





10.2.5 “临界 区 管理 函数 


函数 uCpuEnterCritical () 和 uCpuLeaveCritical () 通过 CPSID、CPSIE 指 令 来 控制 处 理 器 中 断 。 


10.2.6 ”内 核 多 任务 启动 函数 


函数 uCpustartSysTick () 由 内 核 IDLE 线 程 调 用 ， 前 面 章节 曾 介绍 过 ，1DLE 线 程 启动 后 ， 首 先 调 用 本 函数 ， 然 后 进入 无 限 循 环 。 


10.2.7 “线程 优先 级 计算 函数 


函数 uCpuCalcHiPRIO () 通过 RBIT 和 CLZ 指 令 来 加 速 计算 线程 队列 中 的 最 高 线程 优先 级 。 


10.2.8 内核 与 处 理 器 接口 函数 




















函数 uCpulnit () 完成 处 理 器 初始 化 ， 是 设置 主 频 和 系统 心跳 时 钟 中 断 。 该 函数 首先 设置 Systick 参 数 ， 使 得 处 理 器 硬件 时 钟 Systick 按 照 指定 频率 发 出 中 断 ， 目 前 在 STM32F10x 处 理 器 上 是 按照 
72M 处 理 器 频率 和 每 10 毫 秒 一 次 定时 器 中 断 来 设置 的 。 














10.2.9 ”内核 启动 流程 


这 里 我 们 结合 代码 和 注释 来 分 析 内 核 是 如 何 启动 的 〈 见 代码 清单 10-7) 。 内 核 启动 函数 在 文件 kernel.c 中 。 


代码 清单 10-7: 内 核 启 动 函数 





1. void xKernelStart (void) 

2. 1{ 

3 

入 给 化 内 楼 参数 变量 

4. 0 = eOriginstate; 

呈 UKernelVariable.IntrNestTimes = 0u; 

6 UKernelVariable.SchedLocked = eFalse; 

Ts UKernelVariable.IntVectorTable = IntVectorTable; 
:a UKernelVariable.TotalTicks = Ou; 
uKernelVariable.InitialThread = (TThread*)0 
10. 

11. #if ((TCL TIMER ENABLE) && (TCL USER TIMER ENABLE)) 
12, UKernelVariable.TimerdThread = (TThread*)0 
13. #endif 

14. 

Ts YR 

内 核 HOOK 


函数 初始 化 */ 
16. #if ((TCL HOOKS ENABLE) && (TCL IDLE HOOK EEL) 


于 uKernelHook.. IdleHookEntry = (TIdIeHookPntry)0 
18. #endif 
2 

太 
化 二 和 管理 本 a4 

uThreadModuleInit () 7 

2 
23. Fe 


定时 器 模块 初始 化 */ 
24. #if (TCL TIMER ENABLE) 


5 uTimerModuleInit (); 
26. #endif 

27. 

28 . 和 

初始 化 内 核 IDLE 

线程 并 且 激活 */ 

29. uIdleDaemonInit (); 
30. 


是 计 吕 绪 程 初始 化 A 
32. #if ((TCL TIMER ENABLE) && (TCL USER TIMER ENABLE)) 


33， uTimerDaemonInit () ; 
34. #endif 

35 

36. 


JE 
设备 管理 模块 初始 化 */ 
37. #if (TCL DEVICE ENABLE) 


38. uDeviceInit(); 

39. #endif 

40. 

41. uThreadNominee = uKernelVariable.TInitialThread; 
42. uThreadCurrent = ukKkernelVariable.TInitialThread; 
43. 

44. i 

调用 处 理 器 初始 化 函数 */ 

45. KNL ASSERT ( (UKernelRoutine.CpuSetupEntry != 

46. (TCpuSetupEntry) 0), ""); 

47. UKernelRoutine.CpuSetupEntry (); 

48 . 

49 . he 

调用 板 级 初始 化 函数 */ 

& KNL_ASSERT ( (uKernelRoutine.BoardSetupEntry != 
8 加 (TBoardSetupEntry)0), ""); 

52, uUKernelRoutine.BoardSetupEntry(); 

53。 

54. 

调用 设备 初始 化 函数 */ 





55. #if (TCL DEVICE ENABLE) 


56. KNL ASSERT((uKernelRoutine.DeviceSetupEntry != 
SLs (TDevSetupEntry) 0), ""); 

58. UKernelRoutine.DeviceSetupEntry () 7 

59. #endif 

60 . 


六 


61 . 
六 用 用 人 中国 二 此 时 多 线程 机 制 尚未 打开 */ 
KNL ASSERT ( (UKerne1Routine.UserMainEntry != 


6 (TUserMainEntry)0), ""); 
64. ukKernelRoutine.UserMainEntry(); 
65. 

66. A* 

启动 内 核 IDLE 

线程 */ 

67. uCpuLoadIdleThread (); 

68. 

69. while (eTrue) 

70. * 

1. } 

72. 1} 





























注意 在 内 核 启动 之 前 ， 必 须 注册 用 户 应 用 程序 入 口 函 数 。 用 户 可 以 在 这 个 函数 里 初始 化 应 用 线程 ， 对 BSP 和 设备 进行 初始 化 。 代 码 清单 10-8 演 示 了 如 何 注册 一 个 恰当 的 用 户 应 用 函数 。 
























































代码 清单 10-8: 应 用 演示 








1. #include "trochili.h" 

和 

3 

用 户 线 查 允 数 4 

4. #define THREAD LED STACK SIZE (256) 
5. #define THREAD LED PRIORITY (5) 
6. #define THREAD LED SLICE (20) 
和 

8. #define THREAD CTRL STACK SIZE (256) 
9. #define THREAD CTRL PRIORITY (6) 
10. #define THREAD CTRL SLICE (20) 
让 

Ae 

用 户 线程 

13. static TWord ThreadLEDStack[THREAD LED STACK SIZE]; 
14. 

LS: 


用 户 线程 定义 */ 

16. static TThread ThreadLED; 

让 7 

18. 人 

用 户 信号 量 定义 */ 

19. static TSemaphore LedSemaphore; 

20. 

21, /* LED 

线程 的 主 函 数 */ 

22. static void ThreadLEDEntry (void* pArg) 


23。 4 

24. TErrno errno; 
25。 TState state; 
26. while (eTrue) 
27。 { 


2 /* LED 


线程 以 阻塞 方式 获取 信号 量 ， 如 果 成 功 则 点 亮 LED */ 
29. state = TclObtainSemaphore (&LedSemaphore, 


30。 IPC OPT WAIT, 0, &errno); 
3 if (state = eSuccess) 

32。 { 

汪汪 EVB LEDControl (LED1，LED ON) 

34. } 

35。 


36 . /* LED 

线程 以 阻塞 方式 获取 信号 量 ， 如 果 成 功 则 熄灭 LED */ 

FT: state = TclObtainSemaphore (&LedSemaphore, 
38. IPC OPT WAIT, 0, &errno); 
39: 
40. 
41. 
42 . 3 
43. } 

44. 1} 

45. 


46, YL* 
评估 板 按键 中 断 处 理 函 数 */ 


if (state == eSuccess) 


EVB_LEDControl (LED1, LED OFF); 


47. static void EVB KeyISR(TVector vector, TProperty Property, TWord data) 


48. { 
49. if (EVB KeyScan()) 
{ 


51。 /* Key ISR 
以 非 阻塞 方式 ( 

必须 ) 

释放 信号 量 */ 
52. TclIsrReleaseSemaphore (&LedSemaphore); 
53. } 
54. 1} 

55: 

6 

用 户 应 用 程序 入 口 函数 */ 

57. static void APP LEDEntry (void) 


58. { 

Sa TErrno errno; 
60. 

61. 

配置 使 能 评估 板 上 的 LED 

和 KEY 

设备 */ 

62 . EVB LEDConfig () 7 
63 . EVB_ KeyConfig () 7 
64. 

65 。 

设置 和 KEY 


相关 的 外 部 中 断 向 量 */ 


66 . TclSetIntVector (KEY_INT VECTOR, &EVB KeyISsR, 0, 0, 0, 0); 
67. 

68 . 

初始 化 信号 量 */ 

69. TclInitSemaphore (&LedSemaphore, 0, 1, IPC PROP NONE, &errno); 
70. 

71. 

初始 化 LED 

线程 */ 

3 TclInitThread (&ThreadLED, &ThreadLEDENtry, (void*)0, 
3 ThreadLEDStack, THREAD LED STACK SIZE, 
74. THREAD LED PRIORITY, THREAD LED SLICE); 
75 

76. 

激活 LED 

线程 */ 

737 TclActivateThread (&ThreadLED); 

8 

99 

0. 

处 理 器 BOOT 

之 后 会 调用 main 


函数 ， 必 须 提供 */ 


81. extern void EVB SetupDevice (void); 


82. int main (void) 

33。 二 

84. 

注册 处 理 器 初始 化 函数 到 内 核 */ 

35 TclSetCpuEntry (&uCpuInit); 
86. 

87. 了 


注册 板 级 初始 化 函数 到 内 核 */ 
88 . TclSetBoardEntrYy(&EVB_SetupBoard) 7 
89. 


90 . 二 

注册 板 级 调试 打印 函数 到 内 核 */ 

gb. TclSetTraceRoutine (&EVB Uart2Writestr); 
92. 


93 . 
注册 用 户 初始 化 函数 到 内 核 */ 


94. TclSetUserEntry (&APP LEDENtry); 
95, 

96. Ve 

启动 内 核 */ 

97 TclStartKernel (); 

98. 

99， Tetarn 13 

100. } 














在 上 面 的 例子 中 ， 函 数 EVB_LEDAppEntry() 就 是 所 说 的 用 户 应 用 程序 入 























线程 ， 最 后 将 LED 线 程 激活 。 这 个 函数 注册 到 内 核 后 ， 在 内 核 启动 过 程 中 被 调 














执行 。 


10.3 评估 板 介绍 





， 在 这 之 后 ， 内 核 将 通过 IDLE 线 程 启动 多 任务 。 











函数 ， 在 该 函数 里 ， 我 们 初始 化 了 LED 和 KEY 设 备 ， 通 过 内 核 接管 了 KEY 的 中 断 处 理 ， 然 后 初始 化 了 一 个 LED 


为 IDLE 线 程 优先 级 最 低 ， 所 以 LED 线 程 随 即 抢占 IDLE 线 程 ， 


b 箱 和 一 个 LED 











户 程序 开始 





Colibri 是 为 Trochili RTOS 定 制 的 第 一 款 评估 板 ( 见 图 10-8) ， 该 评估 板 基于 STM32F107 处 理 器 。 主 要 用 于 演示 内 核 的 使 用 。 本 书 中 的 示例 代码 都 是 基于 该 评估 板 编写 的 。 该 评估 板 由 底板 和 扩展 板 组 成 ， 
底板 包括 基本 的 功能 模块 ， 可 满足 读者 嵌入 式 学 习 的 需求 ; 底板 同时 突出 网 络 模块 ， 方 便 读者 进行 以 太 网 开发 。 扩 展板 和 底板 是 通过 Arduino 接 口 连接 的 ， 如 果 读 者 有 更 多 的 需求 则 可 以 通过 各 种 Arduino 


Shield 来 进行 功能 扩展 ， 比 如 电机 、 蓝 牙 、Wifi， 以 及 各 种 传感器 等 。 


TROCHILI RTOS 
www.trochili.com 





图 10-8 ”Colibti 评 舍 板 底板 


Colibri 评 估 板 在 功能 设计 上 做 得 尽量 丰富 但 不 失 简 洁 ， 主 要 包括 LED、KEY、UART、SPI、1 2C、 蜂 鸣 器 、 电 位 器 、TF、USB 和 Ethernet 功 能 。 除 这 些 基本 功能 之 外 ， 我 们 又 通过 兼容 现在 非常 流行 的 
Arduino 接 口 来 灵活 地 支持 更 多 的 外 设 。 另 外 板 载 了 JLinkOB 调 试 器 ， 方 便 读者 调试 程序 。Colibri 评 估 板 硬件 详情 见 表 10-7。 




















表 10-7 ”Colibti 评 估 板 硬件 详情 


序号 功能 详情 
1 CPU STM32F107VCT6、64K SRAM、256K FLASH 
3 SWD 接口 ,1 个 JLINK OB 
4 2 个 用 户 按键 ，1 个 重启 按键 
5 LED 3 个 用 户 工 ED 
6 MCU 自 带 MAC 控制 器 ， 外 接 PHY DP83848 
7 USB 转 串 口 引 出 USART1 
8 2M SPL Flich 
9 IIC EEPROM (AT24C02 ) 
10 1 个 TF 卡 座 ，SPI 接 口 
11 USB 1 个 USB device 接口 
13 ADC 电位 大 
14 扩展 功能 1 组 Arduino UNO R3 接口 


b> 本 


15 -小 标准 信用 卡 大 小 ， 美 观 晶 便于 携带 
































前 面 各 章 的 演示 用 例 都 是 基于 LED、KEY 和 UART 的 应 用 ， 这 里 我 们 将 仔细 了 解 这 几 个 设备 的 细节 。 对 于 其 他 板 载 的 设备 ， 我 们 将 提供 单独 的 《Colibri 开 发 板 实验 手册 》 [来 进行 分 析 演示 ， 包 括 SPI、 
IIC、RTC、 定 时 器 、PWM、ADC、TF Card、USB 等 ， 这 些 接 口 和 设备 是 嵌入 式 开发 的 基础 ， 读 者 可 以 把 《实验 手册 》 作 为 STM32 和 嵌入 式 学 习 的 入 门 资料 。 





























[1 读者 可 登陆 www.trochili.com 下 载 。 


10.3.1 LED 驱动 开发 




















Colibri 评 估 板 上 有 3 个 用 户 LED。LED 的 控制 是 通过 操作 STM32 芯 片 的 /O 引 脚 电 平 来 实现 的 。 下 








我 们 就 来 编写 LED BSP 驱动 代码 ， 其 硬件 连接 如 图 10-9 所 示 。 














回 














PC8 本 0 LD1 1 2 Green 


PCO R95 0 LD3 1 2 Green 


By R96 0 LS 1 2 Green 








网 


10-9 评估 板 LED 灯 原理 图 








在 Colibri 评 佑 板 上 控制 LED 的 步骤 如 下 : 


1) 选择 需要 控制 的 特定 GPIO 端 口 引 脚 。 


2) 配置 需要 的 GPIO 特 定 功 能 模式 。 


3) 设置 GPIO 输 出 电压 的 高 低 来 控制 LED 的 点 





代码 清单 10-9: led.c 文 件 代码 





#include "stm32f10x.h" 
#include "stm32f10x rcc.h" 
#include "stm32f10x gpio.h" 
#inclugde "misc.h" 

#include "evb bsp led.h" 


/汪汪 六 大 类 次 次 六 关 交 次 六 灰 交 类 灰 交大 炎 大 类 次 交 交 大 次 次 六 大 次 类 关 磋 次 关头 大大 六 类 交 次 大 关 次 凑 大 磋 次 类 灰 大 六 交大 大大 大 交 大 次 交大 大 交 
x* 

配置 LED 

用 到 的 I/O 

口 ， 使 能 相关 设备 时 钟 

9 


太太 交 炎 诡 六 次 六 次 六 次 六 次 六 次 六 闪闪 关 交 六 次 六 奖 炎 次 六 次 闪 次 六 次 闪 次 次 闪 次 交 术 交 六 奖 六 奖 交 六 次 闪 次 六 次 六 次 灾 交 闪 大奖 大 太 诡 六/ 


co am wb 上 


10. void EVB LEDConfig (void) 





a 

12. fe 

定义 一 个 GPIO InitTypeDef 

类 型 的 结构 体 */ 

于 3 GPIO InitTypeDef GPIO Initstructure; 

14. 

Ty 

开启 GPIOC 

的 外 设 时 钟 */ 

16. RCC_APB2PeriphClockCmd (RCC APB2Periph GPIOC, ENABLE); 
二 7 

18 

选择 要 控制 的 GPIOC 

引 脚 */ 

19. GPIO _InitStructure.GPIO Pin = GPIO Pin 5 | 

2 本 本 GPIO Pin 6 | GPIO Pin 7; 
21. 

2 ye 

设置 引 脚 模式 为 通用 推 挽 输出 */ 

芝 3v GPIO_InitStructure.GPIO Mode = GPIO Mode Out_PP'” 

24. 

25. 

设置 引 脚 速率 为 50MHz */ 

艺 6。 GPIO InitStructure.GPIO Speed = GPIO Speed S50MHz; 

Ss 

28. /* 

调用 库 函 数 ， 初 始 化 GPIOC*/ 

芝 8 GPIO_Init (GPIOC，&GPIO_InitStructure) 7 

30 . 

31。 

关闭 所 有 LED */ 

32. GPIO SetBits (GPIOC, GPIO Pin 5 | GPIO Pin 6 | GPIO Pin 7); 
33. 1 

34. 
ES 
36。 二 

控制 LED 

的 点 亮 和 熄灭 

337 。 认 兴 淆 光大 闪闪 光大 闪闪 光大 次 次 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 关 交 闪光 闪闪 闪光 闪闪 闪光 关 六 闪闪 关 六 闪闪 关 六 闪光 闪闪 闪光 关 六 闪光 太太 了/ 
38. void EVB LEDControl (int index, int cmd) 

B39 


40. if (index == LEDO) 


if (cmd 一 LED OFF) 
{ 

GPIO SetBits (GPIOC, GPIO Pin 5); 
} 


else 


GPIO ResetBits (GPIOC, GPIO Pin 5); 


} 
} 
else if (index == LED1) 
{ 
if (cmd 一 LED OFF) 
{ 
GPIO SetBits (GPIOC, GPIO Pin 6); 
} 


else 


GPIO ResetBits (GPIOC, GPIO Pin 6); 


} 
} 
else if (index == LED2) 
{ 
if (cmd 一 LED OFF) 
上 
GPIO_ SetBits (GPIOC, GPIO Pin 7); 
} 


else 


GPIO ResetBits (GPIOC, GPIO Pin 7); 


} 
} 


else 


if (cmd 一 LED OFF) 

{ 
GPIO SetBits (GPIOC, GPIO Pin 5); 
GPIO SetBits (GPIOC, GPIO Pin 6); 
GPIO SetBits (GPIOC, GPIO Pin 7); 

} 

else 


{ 


GPIO ResetBits (GPIOC, GPIO Pin 5); 
GPIO ResetBits (GPIOC, GPIO Pin 6); 
GPIO ResetBits (GPIOC, GPIO Pin 7); 


} 





(1) LED 设 备 初 始 化 函数 


在 这 个 文件 中 ， 我 们 定义 了 一 个 函数 EVB_LEDConfig () ,在 这 个 函数 里 配置 了 相关 的 GPIO 并 开启 了 时 钟 。 在 调用 该 函数 后 ，GPIOC 的 Pin5、Pin6、Pin7 就 被 配置 成 了 最 高 频率 为 50MHz 的 通用 推 挽 输 


出 模式 。 


在 开启 外 设 时 钟 之 前 ， 我 们 首先 要 配置 好 系统 时 钟 SYSCLK， 而 SYSCLK 已 经 由 SystemInit () 配置 好 了 。GPIO 所 用 的 时 钟 PCLK2 在 这 里 采用 默认 值 72MHz， 这 样 就 不 用 修改 分 频 器 。 但 外 设 时 钟 默认 处 
在 关闭 状态 。 开 启 和 关闭 外 设 时 钟 可 以 通过 库 函 数 RCC_APB2PeriphClockCmd () 来 实现 。 


(2) LED 设 备 控制 函数 


可 以 通过 函数 FEVB_LEDControl () 控制 I/O 口 的 电 平 高 低 ， 从 而 实现 控制 LED 的 亮 与 灭 。 


要 控制 GPIO 引 脚 的 电 平 高 低 ， 只 须 在 GPIOx_BSRR 寄 存 器 相应 的 位 写 入 控制 参数 。 可 以 用 ST 库 函数 来 具体 操作 寄存 器 位 ， 即 用 GPIO_SetBits () 控制 输出 高 电 平 ， 用 GPIO_ResetBits () 控制 输出 低 电 


平 。 


在 LED_GPIO_Config () 函数 中 ， 我 们 在 调用 GPIO_Init () 函数 之 后 就 曾 调用 了 GPIO_SetBits () 函数 ， 从 而 让 这 几 个 引 脚 输出 高 电 平 ， 使 3 蓝 LED 初 始 化 后 都 处 于 熄灭 状态 。 


10.3.2 ”外 部 按键 驱动 开发 








EXTI (external interrupt) 指 的 是 通 

















图 如 图 10-10 所 示 。 




















的 外 部 中 断 ， 通 过 GPIO 检 测 输入 脉冲 ， 引 起 中 断 寻 





件 ， 打 断 原来 的 代码 执行 流程 ， 然 后 进入 中 断 服务 函数 中 进行 处 理 ， 当 寻 
代码 中 执行 。STM32 的 所 有 GPIO 都 可 以 用 作 外 部 中 断 源 的 输入 端 ， 我 们 可 以 用 EXTI 中 断 来 处 理 外 部 按键 的 中 断 。Colibri 评 估 板 上 有 3 个 用 户 KEY ， 
































到 了 其 中 之 一 。 

















务 处 理 完毕 后 ， 再 返回 中 断 之 前 的 
目前 我 们 的 演示 代码 只 


户 KEY1 的 原理 





100nF 


图 10-10 


外 部 按键 驱动 函数 的 代码 如 代码 清单 10-10 所 示 。 


评估 板 外 部 按键 硬件 原理 
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代码 清单 10-10: 外 部 按键 驱动 函数 





1. #include "stm32f10x exti.h" 

2. 村 nclude "stm32f10x gpio.h" 

3. #include "stm32f10x rcc.h" 

4. #include "misc.h" 

本 

配置 PE5 

为 线 中 断口 ， 并 设置 中 断 优先 级 

8 。 六 六 兴 灾 次 关 闪闪 光大 六 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 关 交 闪闪 闪闪 闪光 闪闪 闪光 闫 六 闪光 大 / 

9. void EVB KeyConfig (void) 

TO 

Ts GPIO InitTypeDef GPIO InitStructure; 

Lg EXTI InitTypeDef EXTI InitStructure; 

3 NVIC InitTypeDef NVIC InitStructure; 

14. 

15, /* config the extiline (PD13) clock and AFIO clock */ 

16. RCC APB2PeriphClockCmd (RCC APB2Periph GPIOD | RCC APB2Periph AFIO, 
ENABLE); — 站 加 4 

TT /* config P[AIBICIDIE]13 */ 

18. NVIC InitStructure.NVIC IRQChannel = EXTI15 10 IRQON; 

19。 NVIC_InitStructure.NVIC_IRQOChanne1PreemptionPriority = 0; 

20. NVIC InitSstructure.NVIC IRQChannelSubPriority = 0; 

31 NVIC Initstructure.NVIC IRQChannelCmd = ENABLE; 

22。 NVIC Init (&NVIC InitStructure); 

23 

24. /* EXTI line gpio config(PD13) */ 

这 5。 GPIO InitStructure.GPIO Pin = GPIO Pin 13; 

区 6: GPIO_InitStructure.GPIO Mode = GPIO Mode IPD; 

7 GPIO_ Init (GPIOD, &GPIO Initstructure); 

28. 

229: /* EXTI line(PD13) mode config */ 

30. GPIO EXTILineConfig (GPIO PortSourceGPIOD, GPIO PinSourcel3); 

3 EXTI InitStructure.EXTI Line = EXTI Linel3; 

32: EXTI_InitStructure.EXTI Mode = EXTI Mode Interrupt; 

3 EXTI InitStructure.EXTI Trigger = EXTI Trigger Falling; 

34. EXTI InitSstructure.EXTI LineCmd = ENABLFE; 

35s EXTI Init (gEXTI InitStructure); 

36. 1} 

37; 


人 


8 和 


检查 是 否 有 外 部 按键 事件 产生 


病 站 。 。 汉 汪 肖 大 尖 汉 奉 尖 尖 衣 在 尖 商 友 丰 光 衣 在 视 尖 闪光 源 尖 让 在册 尖 让 光源 宙 让 在 视 尖 训 光 六 尖 调 在 山 尖 让 克 尖 册 在 在 凡 尖 训 克 六 尖 让 在 宙 尖 庆 克 尖 肖 让 在 视 由 让 丰 下 


41. int EVB KeyScan (void) 


42. { 

43. int value = 0; 

44. 

45. if (EXTI GetITStatus (EXTI Linel3) 
46. { 

47. EXTI ClearITPendingBit (EXTI_Line13) 7 
48. value = 1; 

49. : 

50 . 

Bs return value; 

52. } 


在 函数 EVB_KeyConfig () 中 ， 配 置 |/O 为 EXTI 中 断 主 要 有 以 下 步骤 : 


1) 使 能 EXTIx 线 的 时 钟 和 第 二 功能 AFIO 时 钟 。 


!= RESET) 


通过 调用 RCC_APB2PeriphClockCmd () 来 开启 GPIOD 时 钟 和 AFIO 的 时 钟 。 


AFIO (alternate-function I/O) 指 GPIO 端 口 的 复 用 功能 ，GPIO 除 了 用 作 普 通 的 输入 /输出 ( 主 功能 ) ， 还 可 以 作为 片上 外 设 的 复 用 输入 /输出 ， 如 串口 、ADC， 这 些 就 是 复 用 功能 。 大 多 数 GPIO 都 有 一 
个 默认 复 用 功能 。 当 把 GPIO 用 作 EXTI 外 部 中 断 或 使 用 重 映 射 功能 的 时 候 ， 必 须 开启 AFIO 时 钟 ， 而 在 使 用 默认 复 用 功能 时 ， 就 不 必 开 启 AFIO 时 钟 了 。 


2) 配置 EXTIx 线 的 中 断 优先 级 。 


通过 调用 NVIC_PriotityGroupConfig () 库 函 数 ， 把 NVIC 中 断 优先 级 分 组 设置 为 第 1 组 。.NVIC_IRQChannel=EXTI15_10_IRQn 表 示 要 配置 的 为 EXTI10~EXTI15 线 的 中 断 向 量 。 因 为 按键 PD13 对 应 的 EXTI 
线 为 EXTI13， 而 EXTI10~EXTI15 线 共同 使 用 一 个 中 断 向 量 ， 所 以 只 能 写 入 EXTI15_10_IRQn 这 个 参数 。 


3) 配置 EXTI 中 断 线 VO。 


通过 GPIO_Init 配 置 GPIOD 的 Pin13 为 输入 I/O。 


4) EXTI 中 断 线 工作 模式 配置 。 


调用 GPIO_EXTILineConfig () 函数 把 GPIOD 的 Pin13 设 置 为 EXTI 输 入 线 。 最 后 调用 EXTI_Init () 把 EXTI 初 始 化 结构 体 的 参数 写 入 寄存 器 。 各 参数 如 下 : 


-EXTL Line: 选择 EXTI Line13 线 进行 配置 ， 因 为 按键 的 PD13 连 接 了 EXTI_Line13。 


“EXTI_ Mode: 给 EXTI_Mode 成 员 赋 值 。 设 置 模式 为 中 断 模 式 EXTI_Mode_Interrupt。 


“ EXTI_Trigget: 把 触发 方式 (EXTI_Trigger) 设置 为 下 降 沿 触发 (EXTI_Trigger_Falling) 。 


“EXTI LineCmd: 给 EXTI_LineCmd 成 员 赋 值 。 把 EXTI_LineCmd 设 置 为 使 能 。 


在 这 个 EXTI 设 置 中 我 们 把 PD13 连 接 到 内 部 的 EXTI13，GPIO 配 置 为 上 拉 输 入 ， 工 作 在 下 降 沿 中 断 。 在 外 

















为 低 ， 从 而 在 PD13 上 产生 一 个 下 降 沿 跳 变 ，EXTI13 会 捕捉 到 这 一 跳 变 ， 并 产生 相应 的 中 断 。 


函数 EVB_KeyScan () 






































来 检测 是 否 真 的 有 中 断 产生 ， 进 入 中 断后 ， 调 


位 ， 然 后 记录 下 返回 值 为 1， 最 后 退出 中 断 服务 函数 。 


10.3.3 ”串口 驱动 开发 
































Colibri 评 估 板 上 有 1 个 上 











户 串 














， 我 们 主要 通过 该 串 











库 函 数 EXTI_GetITStatus () 来 重新 检查 是 否 产生 了 EXTI_Line 中 断 ， 如 果 是 则 调 





来 打印 程序 执行 时 的 各 种 信息 。UART 硬 件 连接 图 如 图 10-11 所 示 。 























电路 上 我 们 将 PD13 接 到 了 KEY 上 。 当 按键 没有 按 下 时 ，PD13 始 终 为 高 ， 当 按键 按 下 时 PD13 变 


EXTI_ClearlT-PendingBit () 清除 中 断 标 
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图 10-11 评估 板 囊 口 硬件 











Colibri 评 估 板 使 用 了 CH340 芯 片 ， 把 STM32 的 PA10 引 脚 〈( 复 用 功能 为 USART1 的 Rx) 接 到 了 TXD 针 脚 ， 把 PA9 引 脚 ( 复 用 功能 为 USART 的 Tx) 连接 到 了 RXD 针 脚 。UART 驱 动 函 数 如 代码 清单 10-11 所 


代码 清单 10-11: UART 驱 动 函数 





#include "stm32f10x usart.h" 

#include "stm32f10x gpio.h" 

#include "stm32f10x rcc.h" 

#include "evb bsp uart.h" 

/ 兴 炎 六 火炎 火 交 次 炎炎 闪光 交火 次 次 交火 交 六 炎炎 闪光 交火 交 次 类 六 闪光 交火 奖 次 次 尖 闪 六 交火 交 次 次 次 次 关 类 六 闪光 交火 次 次 六 闪光 交火 交 次 次 交 六 大 交大 次 次 光 


初始 化 串口 1 


灾 赤 灾 炎 亦 炎 丙 灾 南 灾 走火 赤 灾 灾 实 灾 灾 灾 灾 灾 宙 灾 灾 赤 灾 下 灾 赤 灾 责 灾 南洋 闪 实 灾 灾 灾 灾 灾 灿 灾 光 赤 灾 丙 灾 赤 灾 责 炎 赤 实 天灾 灾 灾 严守 灾 灾 炎 赤 灾 丙 灾 赤 灾 赤 炎 赤 人 


void EVB UartlConfig (void) 
{ 


io 站 过 mmewb 


PRPRpPRPRbh 
DoowamwmewNPo' 


GPIO InitTypeDef GPIO_InitStructurey 
USART InitTypeDef USART InitStructure; 


/* config USART] clock */ 
RCC_APB2PeriphClockCmd (RCC APB2Periph USART1 | RCC APB2Periph GPIOA, ENABLE); 


/* USART]1 GPIO config */ 
/* Configure USART1 Tx (PA.09) as alternate function push-pull */ 


GPIO InitStructure.GPIO Pin = GPIO Pin 9; 
GPIO InitStructure.GPIO Mode = GPIO Mode AF PP; 


21 GPIO_TnitStructure.GPIO Speed = GPIO Speed 50MHz; 

22。 GPIO Init (GPIOA, &GPIO InitStructure); 

23。 

24. /* Configure USRART1 Rx (PA.10) as input floating */ 

5 GPIO InitStructure.GPIO Pin = GPIO Pin 10; 

26. GPIO InitStructure.GPIO Mode = GPIO Mode IN FLOATING; 

as GPIO Init (GPIOA, &GPIO_InitStructure) 7 

28. 

29. /* USRRT1 mode config */ 

30. USART InitStructure.USART BaudRate = 115200; 

le USART InitStructure.USART WordLength = USART WordLength 8b; 

3 USART InitStructure.USART StopBits = USART StopBits 1; 

33。 USART InitStructure.USART Parity = USART Parity No; 

34. USART InitStructure.USART HardwareFlowControl = 

35, USART HardwareFlowControl None; 

6 USART InitStructure.USART Mode = USART Mode Rx | USART Mode Tx; 
371。 USART Init (USART1, &USART InitStructure); 

38. 

a USART Cmd (USART1, ENABLE); 

40. 1} 

41. 

风 2 。 /六 光 类 磋 兴 闪光 闪光 次 关 闪闪 光 关 闪闪 次 关 闪闪 交 关 闪闪 闪闪 闪闪 次 关 闪闪 次 关 闪闪 次 关 闪闪 次 关 闪闪 次 关 闪闪 次 关 六 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 大 办 
3 

通过 串口 1 

发 送 一 个 字符 

和 Q 和 4 。 。 认 兴 突 光 大兴 闪光 闫 闪闪 次 闪闪 闪光 闪光 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 闪闪 闪光 关 六 闪光 关 交 闪闪 闪闪 闪光 闪闪 闪光 关 六 闪光 大 / 
45. void EVB UartlSendByte (int ch) 

46. { 

47. while (!(USART1->SR &USART FLAG TXE)) 

48. ; 


49. USART1->DR = (ch &0xlFF); 


50. 1} 


51. 

号 这 。 7 入内 放声 表 击 发 宙 坟 寥 南 测 才 怖 守 直 者 吉 共和 才 志和 沁 吉 坎 守 直 夫 家 志 训 改 委 过 吉 寥 二 吉 守 二 潜 宪 守 出 吉 宪 才 二 吉 寥 直 册 喜光 和 十 于 寥 机 出 吉 过 和 才 
53; 和 

从 串口 1 

接收 一 个 字符 

厅 外 。。 尖 兴 突 闪 类 淆 交 闪 类 淆 寥 闪 类 淆 次 交 尖 次 次 交 类 淆 次 交 类 次 次 交 类 次 交 交 尖 次 突 交 尖 次 次 交 类 次 次 交 类 次 交 交 类 次 交 类 突 奖 交 类 次 奖 交 类 次 突 交 类 次 交 交大 次 交 实 类 了/ 
55. void EVB UartlGetByte(char* c 

56. { 

57. while (!(USART1->SR &USART FLAG RXNE)) 

58 . 了 

58。 xc = ((int) (USART1->DR &Ox1FF) ) 7 

60. } 





函数 EVB_Uart1Config () 主要 做 了 如 下 工作 : 





使 能 串口 1 的 时 钟 。 


配置 USART1 的 I/O 。 


' 配置 USART1 的 工作 模式 ， 具 体 波 特 率 为 115200、8 个 数据 位 、1 个 停止 位 、 无 硬件 流 控 制 。 即 1152008-N-1。 



































首先 在 代码 中 调用 了 库 函 数 RCC_APB2PeriphClockCmd () 初始 化 了 USART1 和 GPIOA 的 时 钟 ， 这 是 因为 使 用 了 GPIOA 的 PA9 和 PA10 默 认 复 用 USART1 的 功能 ， 在 使 用 复 用 功能 时 ， 要 开启 相应 的 功 
能 时 钟 USART1。 











































































































接 下 来 ， 对 串口 相关 的 GPIO 进 行 初始 化 。 此 时 我 们 使 用 的 GPIO 的 复 用 功能 为 串口 ， 使 用 PA9 和 PA10 用 作 串 口 的 Tx 和 Rx。Tx 为 发 送 端 ， 输 出 引 脚 ， 而 且 现在 GPIO 是 使 用 复 用 功能 ， 所 以 要 把 它 配置 为 
复 用 推 挽 输 出 (GPIO_Mode_AF_PP) ; 而 Rx 引 脚 为 接收 端 ， 输 入 引 脚 ， 所 以 配置 为 浮 空 输入 模式 GPIO_Mode IN_FLOATING。 























最 后 是 串口 的 模式 、 波 特 率 的 初始 化 。 











: USART_BaudRate=115200; 

“ 波 特 率 设置 ， 利 用 库 函 数 ， 我 们 可 以 直接 配置 波 特 率 ， 而 不 需要 自行 计算 USARTDIV 的 分 频 因子 。 在 这 里 把 串口 的 波 特 率 设置 为 115200。 
: USART_WordLength=USART WordLength_8b; 

“ 配置 串口 传输 的 字 长 。 本 例 程 把 它 设置 为 最 常用 的 8 位 字 长 。 

: USART StopBits=USART_ StopBits_1; 

“ 配置 停止 位 。 把 通信 协议 中 的 停止 位 设置 为 1 位 。 

: USART_Parity=USART_Parity_No; 

“ 配置 奇偶 校 验 位 。 本 例 程 不 设置 奇偶 校 验 位 。 

: USART_HardwareFlowControl=USART_HardwareFlowControl_None; 
“ 配置 硬件 流 控制 。 我 们 这 里 没有 采用 硬件 流 。 

: USART_ Mode=USART_ Mode_Rx|USART Mode_Tx; 


“ 配置 串口 的 模式 。 为 了 配置 双 线 全 双 工 通信 ， 需 要 把 Rx 和 Tx 模式 都 开启 。 


























填充 完结 构 体 后 ， 调 用 库 函 数 USART _Init () 向 寡 存 器 写 入 配置 参数 。 最 后 ， 通 过 调用 库 函 数 USART Cmd () 来 使 能 USART1 外 设 。 











第 11 章 ”以 太 网 实践 


TCP/IP 协 议 徐 是 计算 机 网 络 通 信 协 议 的 一 种 ， 它 是 Internet (国际 互联 网 络 ) 的 基础 。 该 协议 徐 定 义 了 各 类 计算 机 及 网 络 互 联 设 备 如 何 接 入 Internet， 以 及 数据 在 它们 之 间 如 何 传输 。 本 章 将 以 TCP/IP 协 
议 栈 为 出 发 点 ， 通 过 一 个 庶 入 式 TCP/IP 协 议 栈 的 应 用 实例 来 演示 Trochili RTOS。 


11.1 ”以太 网 和 以 太 网 协议 栈 











以 太 网 (Ethernet) 是 互联 网 技术 的 一 种 ， 指 的 是 遵守 IEEE 802.3 标 准 组 成 的 局 域 网 。 主 要 是 位 于 参考 模型 的 物理 层 (PHY) 和 数据 链 路 层 中 的 媒体 接 入 控制 子 层 (MAC) 。 



































设计 网 络 时 ， 为 了 降低 网 络 设计 的 复杂 性 ， 对 组 成 网 络 的 硬件 、 软 件 进行 封装 、 分 层 ， 这 些 分 层 即 构成 了 网 络 体系 模型 。 在 两 个 设备 相同 层 之 间 的 对 话 、 通 信 约 定 ， 构 成 了 层级 协议 。 设 备 中 使 用 的 所 
有 协议 加 起 来 统称 协议 栈 。 例 如 ，1SO 国 际 标准 组 织 所 定义 的 开放 系统 互联 七 层 模型 ， 是 一 组 不 同 层次 上 的 多 个 协议 的 组 合 。 目 前 广泛 应 用 的 TCP/IP 协 议 与 OSI 七 层 模型 并 不 完全 匹配 ， 被 认为 是 一 个 四 层 协 
议 系统 。 
























































TCP/IP 模 型 由 4 个 层次 组 成 ， 分 别 是 链 路 层 、 网 络 层 、 传 输 层 和 应 用 层 ， 如 图 11-1 所 示 。 
































链 路 层 ， 也 称 作 网 络 接口 











特性 、 功 能 特性 、 规 程 特性 。 








屋 或 数据 链 路 层 ， 























网 络 层 ， 又 称 I|P 层 ， 主 要 处 理 计算 机 之 间 的 通信 问题 。 它 主 





1) 处 理 来 自传 输 

















2) 处 理 接收 到 的 数据 报 ， 使 





个 分 组 报 文 ; 否则 ， 继 续 向 前 发 送 该 数据 报 。 





3) 处 理 路 由 选择 、 差 错 检测 





传输 层 的 基本 任务 是 提供 应 












































路 由 选择 





程序 之 间 的 通信 


与 恢复 、 流 量 控制 、 网 络 拥塞 等 问题 。 





到 这 个 目的 ， 传 输 层 的 协议 软件 需要 进行 协商 ， 让 接收 方 




















应 用 层 是 TCP/IP 模 型 的 最 高 








回 送 确认 信息 

















可 以 选择 所 需要 的 传输 








实际 上 ， 在 发 送 数据 时 ， 经 过 网 络 协议 栈 的 每 一 














户 通过 调用 应 











， 若 未 


完成 了 以 下 三 个 功能 : 


它 通过 网 络 设备 驱动 程序 ， 接 收 IP 数 据 报 ， 并 把 数据 报 通过 选 定 的 网 络 接 








屋 的 分 组 发 送 请 求 。 它 把 分 组 封装 到 IP 数据 报 中 ， 填 入 数据 报 的 首部 ， 使 











民 务 ， 这 种 通信 又 称 为 端 到 端的 通信 。 传 输 














图 11-1 TCP/IP 参 考 模型 

















发 送出 去 。 同 时 ， 链 路 








屋 还 定义 了 传输 的 物理 媒介 的 各 种 特性 : 机 械 特性 、 电 子 





路 由 算法 选择 最 佳 路 径 ， 然 后 将 数据 报 发 送 至 适当 的 网 络 接口 。 


法 决定 是 在 本 地 进行 处 理 ， 还 是 继续 向 前 发 送 。 如 果 数 据 报 的 目标 机 处 于 本 机 所 在 的 网 络 ， 该 层 程序 就 解析 数 





























居 报 ， 然 后 选择 适当 的 传输 层 协议 软件 来 处 理 这 





收 到 确认 信息 ， 














层 ， 都 会 对 来 自 上 














层 的 数据 进行 封装 ， 然 





向 下 层 传送 。 





层 既 要 系统 地 管理 数据 信息 的 流动 ， 还 





发 送 方 将 重 发 丢失 的 报 文 。 








后 传递 给 下 一 








， 程序 ， 如 电子 邮件 、 文 件 传输 访问 、 远 程 登录 等 来 访问 TCP/IP 互 联网 络 ， 以 享受 网 络 提供 的 各 种 服务 。 应 F 
肛 务 类 型 ， 并 把 数据 按照 传输 层 的 要 求 组 织 好 ， 表 


层 。 在 接收 方 收 到 数据 时 ， 


提供 可 靠 的 传输 服务 ， 以 确保 数据 准确 而 有 序 地 到 达 目 的 地 。 为 了 达 





























程序 负责 发 送 和 接收 数据 ， 每 个 应 








程序 





























慨 层 地 把 所 在 层 的 数据 包 的 头 去 掉 ， 向 上 层 递 交 数 据 





， 见 图 11-2。 











用 户 数据 





应 用 程序 


用 户 数据 


-7 


目 


以 太 网 
驱动 程序 


首部 TCP 首 | 部 应 用 数据 vy 以 大 网 


14 20 20 
LR 以 太 网 由 | 
[46 ~1500 字 节 一 一 >| 


图 11-2 ”数据 经 过 每 一 层 的 封装 和 还 原 




















目前 常见 的 嵌入 式 TCP/IP 协 议 栈 有 LwlIP、ulP、Microchip TCPIP 协 议 栈 等 。 它 们 多 适合 运行 在 资源 受 限 的 嵌入 式 系统 中 ， 可 以 在 几 百 字 节 或 者 几 十 KB 的 RAM 空 间 中 运行 。 为 了 演示 Trochili RTOS 的 
， 作 者 移植 了 LwIP 协 议 栈 ,编写 了 一 个 网 络 服务 线程 ， 实 现 了 一 个 简单 的 Web 服 务 器 ， 这 样 用 户 通 过 浏览 器 就 可 以 访问 控制 开发 板 上 的 设备 。 这 里 我 们 用 到 的 是 LED 外 设 。 


























11.2 ”MCU 接 入 以 太 网 的 方式 












































STM32F107 型 号 芯片 使 用 MI/RMI1II 接 口 与 PHY 构 成 的 以 太 网 接口 见 图 11-3 (省 略 了 以 太 网 变压器 ) 。 


TXD[3:0] 
TX ER 


MDIO 


ail5622 








图 11-3 STM32F107 与 PHY 芯 片 构成 以 太 网 接口 


















































对 于 没有 集成 以 太 网 控制 器 的 MCU， 可 通过 外 接 以 太 网 控制 器 芯片 接 入 以 太 网 。 比 如 STM32 F103 系 列 的 处 理 器 ， 因 为 自身 没有 以 太 网 控制 器 ， 所 以 经 常 有 人 采用 SPI 接 口 的 以 太 网 芯片 来 接 入 网 路 。 
例如 常见 的 ENC28J60 攻 片 ， 兼 容 IEEE 802.3 的 以 太 网 控制 器 ， 集 成 MAC 控 制 器 和 10 BASE-T PHY 控 制 器 ， 自 带 缓冲 区 、DMA,， 使 用 SPI 接 口 与 MCU 进 行 通信 。MCU 使 用 SPI 对 ENC28J60 芯 片 的 寄存 器 写 



































入 控制 参数 和 接收 数据 ， 实 现 以 太 网 的 功能 。 它 与 MCU 连 接 组 成 的 以 太 网 接口 见 图 11-4。 





ENC28J60 






以 太 网 
变压器 


图 11-4 ”MCU 与 ENC28J60 组 成 以 太 网 接口 








另外 还 有 一 种 以 太 网 控制 芯片 ， 内 部 已 经 集成 了 TCP/IP 协 议 栈 ， 这 样 对 于 MCU 来 说 ， 只 需要 标准 的 UART/SPI 等 常见 的 接口 就 可 以 实现 联网 。 比 如 在 Arduino 用 户 中 常用 的 Wiz5100 等 以 太 网 Shield 采 
用 的 就 是 这 种 方式 。 











11.3 ”以 太 网 控制 器 和 驱动 开发 


Colibri 评 估 板 带 有 一 个 以 太 网 控制 器 ， 其 原理 图 如 图 11-5 所 示 。 以 太 网 控制 信号 的 GPIO 引 脚 分 配 见 表 11-1。 
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图 11-5 STM32F107ETH 硬 件 连接 图 
表 11-1 以 太 网 控制 信号 的 GPIO 引 脚 分 配 


空 制 器 信和 号 GPIO 引 脚 控制 器 信号 GPIO 引 脚 
ETH MI MDO PA2 ETH MII RX DV PDS8 
ETH MI MDC PCl ETH MII RX CLK PA1 
ETH MII TX EN PB11 ETH MII RX ER PB10 
ETH MII TX CLK PC3 ETH MII RXDO PD9 
ETH MII TXDO PB12 ETH MII RXD] PD10 
ETH MI TXD!1 PB13 ETH MII RXD2 PD11 
ETH MI TXD2 PC2 ETH MII RXD3 PD12 
ETH MII TXD3 PB8 




















STM32F107 的 以 太 网 模块 由 MAC 802.3 (介质 访问 控制 器 ) 、 独 立 于 介质 的 接口 (MIMRMII) 管理 模块 和 一 个 专用 的 DMA 控 制 器 组 成 。MCU 通 过 M1I 接 口 与 PHY 芯 片 DP83848 通 信 。ST 提 供 了 以 太 
网 驱动 库 函 数 ， 下 面 我 们 分 析 一 下 相关 代码 的 功能 。 





























1 以太 网 控制 器 配置 函数 





以 太 网 驱动 代码 的 关键 部 分 是 以 太 网 控制 器 的 硬件 配置 函数 Ethernet Config () ， 它 的 功能 主要 包括 MIMRMII 接 口 选择 、 自 适应 功能 选择 、 硬 件 CRC 功 能 、DMA 的 相关 配置 等 ， 其 源 代码 如 代码 清和 
11-1 所 示 。 

















代码 清单 11-1: 以 太 网 控制 器 配置 函数 


I 














1 void Ethernet Config (void) 

和 

3 ETH InitTypeDef ETH InitStructure; 

4 

5 小 

选择 MTI 

接口 */ 

6. GPIO ETH MediaInterfaceConfig (GPIO ETH MediaInterface MIT); 
Pe 

8. 

在 PR8 

引 脚 输出 25MHZ 

的 时 钟 */ 

9. RCC_MCOConfig (RCC_ MCO HSE); 

oR 

11. J 

复位 以 太 网 控制 器 模块 */ 

hi ETH DeInit(); 

13. 

14. 了 

复位 MAC */ 

15, ETH SoftwareReset (); 

16. 

17. 

等 待 复位 完成 */ 

18: while (ETH GetSoftwareResetStatus() 一 SET); 
ig 

20. 上 

初始 化 以 太 网 参数 结构 */ 

到。 ETH StructInit (&ETH InitStructure) 7 

22: 

23，。 

开启 自 适应 功能 */ 

24. ETH InitStructure.ETH AutoNegotiation = 
2 “ETH AutoNegotiation Fnable; 

26. 

7 守 

关闭 环 路 功能 */ 

28 . ETH InitStructure.ETH LoopbackMode = 
29. “ETH LoopbackMode Disable; 

30. 

31。 J 

关闭 重复 传输 功能 */ 

32 . ETH InitStructure.ETH RetryTransmission = 
33. “ETH RetryTransmission Disable; 

34. 

35。 

自动 填充 CRC 

数据 */ 

35。 ETH InitStructure.ETH AutomaticPaqdCRCStrip = 
37, ETH AutomaticPadCRCStrip Disable; 

38. 

3 二 

不 接收 所 有 报 文 */ 

40 . ETH InitStructure.ETH ReceiveAll = ETH ReceiveAll Disable; 
41. 

42. 

使 能 广播 报 文 的 接收 */ 

43. ETH InitStructure.ETH BroadcastFramesReception = 
44. “ETH BroadcastFramesReception Enable; 
45. 

46. 

关闭 地 址 过 滤器 */ 

47. ETH InitStructure.ETH PromiscuousMode = 
48. “ETH_PromiscuousMode Disable; 

49. 


大 


50. 
开启 接收 到 的 多 播 帧 过 滤 模 式 */ 





5 ETH InitStructure.ETH MulticastFramesFilter = 
52 ETH MulticastFramesFilter Perfect; 

53。 

54 . 

开启 接收 到 的 单 播 帧 过 滤 模 式 */ 

S5。 ETH_InitStructure.ETH UnicastFramesFilter = 
56. ETH UnicastFramesFilter Perfect; 

57s 

58-  /* 

使 能 硬件 CRC 


校 验 功能 */ 
59. #ifdef CHECKSUM BY HARDWARE 


60. ETH InitSstructure.ETH ChecksumOffload = 

GL ETH ChecksumOoffload Fnable; 

62. #endif oY 

63. 

64. 

丢弃 校 验 和 错误 帧 */ 

65 . ETH InitStructure.ETH _ DropTCPIPChecksumErrorFrame = 
66. “ETH DropTCPIPChecksumErrorFrame Fnable; 


67. 


lie 天 所 有 错误 由 x 


2 
2 


ETH InitStructure.ETH ForwardErrorFrames = 
“ETH ForwardErrorFrames Disable; 


四 


毛 收 到 突 E 整 帧 后 ，DMA 
控制 器 启动 传输 */ 


有 对。 
74. 
了 
?6 
了 


ETH InitStructure.ETH ReceiveStoreForward = 
ETH ReceiveStoreForward Enable; 
ETH InitStructure.ETH TransmitStoreForward = 
“ETH TransmitStoreForward Enable; 


18, J 
丢弃 所 有 接收 到 的 长 度 小 于 64 
字 节 的 帧 */ 


7 
80. 
81. 


ETH InitStructure.ETH ForwardUndersizedGoodFrames = 
ETH ForwardUndersizedGoodFrames Disable; 


82 . /* DMA 
发 送 控制 器 在 发 送 数据 帧 时 不 需要 同步 前 一 个 帧 的 发 送 状态 */ 


83。 
84. 
上: 


ETH InitStructure.ETH SecondFrameOperate = 
“ETH_SecondFrameOperate Fnable; 


/* AHB 





六 本 以 突 发 传输 固定 长 度 的 数据 */ 
838. 
89. 














ETH InitStructure.ETH FixedBurst = ETH FixedBurst Enable; 
ETH InitStructure.ETH { RxDMABurstLength = 
“ETH RxDMABurstLength 32Beat; 
ETH InitSstructure.ETH TxDMABurstLength = 
“ETH | TxDMABurstLength 32Beat; 
ETH InitSstructure.ETH AddressAlignedBeats = 
ETH AddressAlignedBeats Enable; 


/* 


DMA 
发 送 和 接收 通道 同时 访问 AHB 


主 接口 时 ，DMA 
和 全 和 用 的 用 六 天 寺 行 仲裁 ， 


其 Et 和 人 这 的 人 和 比例 为 2: 二 二 


8 
29， 


100 . 


ETH InitStructure.ETH DMAArbitration = 
“ETH DMAArbitration RoundRobin RxTx 2 1 区 


六 


调用 配置 函数 ， 配 置 以 上 参数 */ 


L101 
102, 


ETH Init (&ETH InitSstructure, PHY ADDRESS); 


103. 1 
使 能 接收 中 断 */ 





104. ETH DMAITCoNfig (ETH DMA IT NIS | ETH DMA IT R, ENABLE); 
105. } 
2. 数据 接收 函数 


函数 ETH_RxPkt_ChainMode 是 以 太 网 驱动 的 接收 函数 ， 它 将 DMA 接 收 控制 器 中 的 数 


代码 清单 11-2: 以 太 网 控制 器 数据 接收 函数 





居 报 文 复制 到 接收 缓冲 





区 中 。 其 函数 源 代码 如 代码 清 


单 11-2 所 示 。 








FrameTypeDef ETH RxPkt ChainMode (void) 
{ 


U32 framelength = 
FrameTypeDef frame = {0,0}; 


dos 否 被 DMA 


f( (DMARxDescToGet->Status&ETH DMARxDesc OWN) !=(u32)RESET) 


{ 
frame.length = ETH ERROR; 


/* 


当 DMA 
的 接收 报 文 缓冲 区 标志 ETH_DMASR_RBUS 


人 说 明 当 


前 入 收 缓冲 区 不 可 用 ， 需要 
93: 
1 
15. 
16. 
I 











18, 


获取 











白 使 能 接收 */ 
if ((ETH->DMASR & ETH DMASR RBUS) != (u32)RESET) 
{ 

ETH->DMASR = ETH DMASR RBUS; 


/* 


使 能 DMA 
接收 报 文 */ 


ETH->DMARPDR = 0; 
} 


return frame; 


/*DMA 
控制 器 接收 报 文 完毕 ，CPU 
卖 取 DMA 
区 里 的 报 文 */ 
if(((DMARxDescToGet->Status & ETH DMARxDesc ES)==(u32)RESET) 
&& ( (DMARxDescToGet->Status & ETH DMARxDesc LS) != (u32)RESET) 
&( (DMARxDescToGet ->StatusgETH DMARxDesc FS) !=(u32)RESET)) 
{ 


/* 
眼 文 长 度 ， 该 报 文 长 度 不 含有 4 


字 节 CRC 
校 验 字 节 */ 


29s 
0 


43. 


framelength = ( (DMARxDescToGet->Status & ETH DMARxDesc FL) 
>> ETH _ DMARxDesc FrameLengthShift) - 4; 





/* 
及 文 缓冲 区 的 地 址 */ 
frame.buffer = DMARxDescToGet->BufferlAddr; 


framelength = ETH ERROR; 
} 
frame.length = framelength; 
frame.descriptor = DMARxDescToGet; 


Pa 


更 新 DMA 
接收 缓冲 区 */ 


44. 
2: 


DMARxDescToGet= (ETH DMADESCTypeDef*) (DMARxDescToGet-> 
Buffer2NextDescAddr); 


大 


各 回报 文 二 结 。 / 


i 


return (frame); 


} 





3. 数据 发 送 函 数 


函数 FTH_TxPkt_ChainMode 是 以 太 网 发 送 函 数 ， 该 函数 通过 DMA 发 送 控制 器 可 以 发 送 该 缓冲 区 中 的 数据 。 其 源 代码 如 代码 清单 11-3 所 示 。 


代码 清单 11-3: 以 太 网 控制 器 数据 发 送 函 数 





本 U32 ETH TxPkt ChainMode (u16 FrameLength) 

2. { 

3. 二 

检查 该 报 文 是 否 已 传送 到 DMA 

的 RAM 

区 域 */ 

4. if( (DMATxDescToSet->Status&ETH DMATxDesc OWN) != (u32)RESET) 
5. { 

J 


CPU 
te 则 返回 错误 */ 


人 
9 


return ETH ERROR; 
} 


大 


10., 
设 定 发 送 报 文 数据 长 度 : 位 [12:0] */ 





1 DMATxDescToSet->ControlBufferSize = (FrameLength & ETH DMATxDesc TBS1); 
本 个 发 送 描述 符 里 发 送 一 帧 数据 */ 
DMATxDescToSet->Status |= ETH DMATxDesc LS | 
和 ETH_DMATxDesc_FS; 
16. 
Ls 
触发 发 送 */ 
18. DMATxDescToSet->Status |= ETH DMATxDesc OWN; 
认 训 是 是 否 可 以 发 送 数据 */ 
if ((ETH->DMASR & ETH DMASR TBUS) != (u32)RESET) 
2 { 
23. ETH->DMASR = ETH DMASR TBUS; 
24. 
5 大 
重新 启动 发 送 */ 
26. ETH->DMATPDR = 0; 
27. } 
28. DMATxDescToSet = (ETH DMADESCTypeDef*) (DMATxDescToSet-> 
29. 及 Buffer2NextDescAddr); 
30. 
3 fe 
党 四 碟 瑟 滞 训 ed 
return ETH SUCCESS; 
3 } 





4. 以 太 网 启动 函数 


该 函数 使 能 MAC 控 制 器 在 MIl 总 线 上 的 发 送 和 接收 功能 ， 使 能 DMA 控 制 器 的 发 送 和 接收 功能 。 


代码 清单 11-4: 以 太 网 控制 器 启动 函数 





其 源 代码 如 代码 清单 11-4 所 示 。 





bit Sa a 


void ETH Start (void) 
{ 六 


[能 MAC 
s 制 器 在 MII 
总 线 上 的 发 送 功 能 */ 


ETH MACTransmissionCmd (ENABLE); 
/* 

空 发 送 FIFO */ 
ETH FlushTransmitFIFO(); 


/* 


使 能 MAC 
控制 器 在 MII 
总 线 上 的 接收 功能 */ 





0 ETH MACReceptionCmd (ENABLE) ; 
Ts 
12: i 
启动 PMA 
发 送 控制 器 */ 
3 ETH DMATransmissionCmd (ENABLE); 
14. 
15, J 
启动 PMA 
接收 控制 器 */ 
16. ETH_DMAReceptionCmd (ENABLE) ; 
17. 1} 
5，DMA 配 置 函 数 


DMA 模 块 的 发 送 控制 器 负责 把 数据 从 系统 存储 器 转送 至 发 送 FIFO， 而 接收 控制 器 负责 把 数据 从 接收 FIFO 读 出 到 系统 存储 器 。DMA 控 制 器 利 
结构 的 DMA 接 收 描述 符 进行 初始 化 。 其 源 代码 如 代码 清 





单 11-5 所 示 。 





代码 清单 11-5: DMA 接 收 描述 符 函数 














描述 








l 符 来 实现 数据 从 


端 到 




















的 端 之 间 的 移动 。 需 要 对 链 





2 
3 
4. 
5. 
bs 
7 
将 


void ETH DMARxDescChainInit (ETH DMADESCTypeDef *DMARxDescTab, 
uint8 t *RxBuff, uint32 t RxBuffCount) 
{ 
uint32 t i = 0; 
ETH_ DMADESCTypeDef *DMARxDesc; 


四 


5 / 
全 局 变量 指针 DMARxDescToGet 


指向 DMA 
接收 描述 符 列表 DMARxDescTab 
的 基地 址 */ 


号 DMARxDescToGet = DMARxDescTab; 
9。 for(i=0; i < RxBuffCount; i++) 
10. 二 

a 至 

将 DMA 

接收 描述 符 列表 DMARxDescTab 


al 首 地 址 赋值 给 DMARxDesc */ 


1 


14. 


DMARxDesc = DMARxDescTabti; 


四 


该 描述 符 被 DMA 
占用 */ 


15, 


6s 
Ts 


DMARxDesc->Status = ETH DMARxDesc OWN; 
DMARxDesc->ControlBufferSize = ETH DMARxDesc RCH | 
(uint32 t)ETH MAX PACKET SIZE; 


18. 


了 有 


/* 


将 接收 描述 符 缓冲 区 1 

的 地 址 指向 接收 缓存 RxBuff 

中 的 相应 地 址 */ 

20. DMARxDesc->BufferlAddr = 

21. (uint32 t) (&RxBuff [i*ETH MAX PACKET SIZE]); 


23. /* 


将 DMA 

接收 描述 符 形成 " 

链 结构 "*/ 

24. if(i < (RxBuffCount-1)) 


Es DMARxDesc->Buffer2NextDescAddr = 
(uint32 七 ) (DMARxDescTab+ti+1); 
27. } 
28。 else 
29. 4 
30 DMARxDesc->Buffer2NextDescAddr = 
31。 (uint32 t) (DMARxDescTab); 


33. } 
35. A 

将 DMA 

后 收 东 术 符 列表 的 基地 址 写 入 间 存 罗 PRDTZR 


36 . ETH->DMARDLAR = (uint32 t) DMARxDescTab; 
7 








5. DMA 发 送 描述 符 函 数 
ETH_DMATxDescChainlnit 函 数 对 链 结构 的 DMA 发 送 描述 符 进行 了 初始 化 。 


代码 清单 11-6: DMA 发 送 描述 符 函 数 





void ETH DMATxDescChainInit (ETH DMADESCTypeDef *DMATxDescTab, uint8 t* TxBuff, uint32 t TxBuffCount) 


1 

2. 1{ 

3, uint32 t i= 0; 

4 ETH_ DMADESCTypeDef *DMATxDesc; 
5 
6 


Di 
接收 描述 符 列表 DMATxDescTab 
的 基地 址 */ 


的 基 

Ts DMATxDescToSet = DMATxDescTab; 

8. 

9, 

填充 DMATxDesc 

表 */ 

9. for (i=0; i < TxBuffCount; i++) 

a { 

下 DMATxDesc = DMATxDescTab + i; 

13s DMATxDesc->Status = ETH DMATxDesc_ TCH; 

14。 DMATxDesc->BufferlAddr = (uint32 t) (&TxBuff[i*ETH MAX PACKET SIZE]); 
15, if(i < (TxBuffCount-1)) 

16. 

17. DMATxDesc->Buffer2NextDescAddr = (uint32 t) (DMATxDescTab+i+1); 
18. } 

9 else 

20. { 

21。 DMATxDesc->Buffer2NextDescAddr = (uint32 t) DMATxDescTab; 
22. 

23. 和 

24. 

25; 

将 DMA 

发 送 描述 符 列表 的 基地 址 写 入 寄存 器 DMATDLAR 

中 

26. ETH->DMATDLAR = (uint32 t) DMATxDescTab; 

27x 豆 











以 上 这 些 函 数 提供 了 以 太 网 驱动 的 主要 功能 。 我 们 只 需要 处 理 GPIO 配 置 和 配置 中 断 就 行 了 ， 相 关 代码 就 不 再 过 多 分 析 了 。 





11.4 ”基于 RTOS 的 Web 实 验 














在 这 个 例 程 里 ， 我 们 使 用 Colibri 评 估 板 ， 通 过 STM32F107 的 以 太 网 控制 器 接 入 局 域 网 。 同 时 移植 Lwip 协 议 栈 ， 并 利用 协议 栈 提供 的 函数 在 STM32 上 建立 TCP 应 用 。 结 合 上 位 机 浏览 器 ， 实 现 控制 评估 
板 上 的 LED 灯 的 应 用 。 我 们 的 目的 是 主要 是 演示 如 何 使 用 RATOS， 所 以 这 里 对 以 太 网 协议 栈 的 代码 不 做 过 多 分 析 ， 读 者 可 以 自己 查阅 相关 资料 。 






























































11.4.1 例 程 分 析 











下 面 的 代码 演示 了 如 何在 Trochili 操 作 系统 上 实现 一 个 简单 的 Web 服 务 器 。 该 例 程 会 在 用 户 应 用 程序 入 口 函 数 内 初始 化 网 络 服务 线程 ， 然 后 启动 内 核 。 在 网 络 服务 线程 内 ， 首 先 初始 化 相关 硬件 ; 然后 向 
内 核 注册 协议 栈 用 于 处 理 周期 事务 的 定时 器 ;随后 初始 化 以 太 网 中 断 ， 注 册 相 关 ISR;， 最 后 启动 网 络 服务 线程 主 循环 ， 然 后 等 待 网 络 和 应 用 程序 的 同步 信息 。 一 旦 以 太 网 中 断 到 达 ， 则 以 太 网 ISR 立 刻 通 知 网 
络 服务 线程 执行 ， 它 会 通过 以 太 网 驱动 程序 接收 网 络 数据 包 ， 整 个 网 络 协议 运行 在 网 络 服务 线程 内 。 其 主 应 用 的 实现 见 代码 清单 11-7。 































































































代码 清单 11-7: 基于 Trochili 操 作 系统 的 Web 应 用 





1. #include "example.h" 

2. #include "trochili.h" 

3. #include "Colibri bsp eth.h" 
4. #include "stm32 eth.h™ 

5。 #include "netconf.h" 

6 
7 
8 


#if (EVB EXAMPLE 一 CH11 NET LWIP FXAMPLE) 


9 2 

用 户 线程 参数 */ 

10. #define THREAD LWIP STACK SIZE (512) 

11. #define THREAD LWIP PRIORITY (6) 

12. #define THREAD LWIP SLICE (20) 

1 

14. J/* 

用 户 线程 栈 定义 */ 

15. static TWord ThreadLwipStack[THREAD LWIP STACK SIZE]; 


用 户 线 程 定义 */ 
18. static TThread ThreadLwip7 
谋生 
20. 7 
以 太 网 中 断 处 理 函 数 */ 
21. static void EVB EthISR (TVector vector, TProperty Property TWord data) 
2 二 
23. while (ETH GetRxPktSize() != 0) 
24. { 
人 LwIP Pkt Handle(); 
26. } 
27. ETH DMAClearITPendingBit (ETH DMA IT R); 
28. ETH DMAClearITPendingBit (ETH DMA IT NIS); 
29. 六 
30. 
31. 
部 jx 用 和 时 和 结构 协议 栈 定时 变量 和 函数 */ 
static TTimer NetTimer; 
static volatile U32 LocalTime = 0; 
34. static void UpdateLocalTime (TTimerData data) 





35.。 f 
S36 LocalTime += 10; 
7s 地 
3 

/* Web 
服务 关 主 本 归 
40. static void WebAppEntry (void* pArg) 
41. { 
42. UKernelTrace (" 
感谢 使 用 Trochili RTOS\r\n"); 
43. UKernelTrace ("www.trochili.com\r\n"); 
44. UKernelTrace ("\r\n"); 
45. uKernelTrace ("##### 
以 太 网 WEB 
试验 #####\r\n") 7 
46. 
47. 
网 络 控 制 器 初始 化 */ 
48. EVB EthSetup(); 
2 
部 机 A 

LwIP Init(); 
a 
/* Web 

服务 器 初 红 化 #7/ 
5 httpd init(); 
55 可 
56 . 
初始 化 网 络 定时 器 */ 
5 TclInitUserTimer (&gNetTimer, eAppPeriodicTimer, 
58: MLS2TICKS (1000), &UpdateLocalTime, 0); 
59; 
60. /* Web 
服务 器 主 函数 */ 
61. while (eTrue) 
62. { 
63. LwIP Periodic Handle (LocalTime); 
64. } 
65; 六 
66. 
67. 


用 户 克 由 入 口 函 数 */ 
68. static void EthAppEntry (void) 








G9 

30s TErrno errno; 

本 家 全 和 评估 板 上 的 LED 

设备 */ 

13: EVB_LEDConfig(); 

74. 

25 Wn 

初始 化 LED 

设备 控制 线程 */ 

了 全， TclInitThread (&ThreadLwip, &WebAppEntry, (void*)0, 
有 ThreadLwipStack, THREAD LWIP STACK SIZE, 
78. THREAD LWIP PRIORITY, THREAD LWIP SLICE); 
9 

80. wR 

设置 ETH 

相关 的 中 断 向 量 */ 

81 . TclSetIntVector (ETH_INT_VECTOR， INTVEC PROP DUMMY, &EVB EthISR, 0, 0); 
82. 

83. 

激活 主 控 线程 */ 

84. TclActivateThread (&ThreadLwip) 
5。 } 

86. 

87. 

88. /* 

处 理 器 BOOT 

之 后 会 调用 main 

函数 ， 必 须 提供 */ 

89. int main (void) 

90. { 

91. Li 

注册 处 理 器 初始 化 函数 到 内 核 */ 

92。 TclSetCpuEntry (&uCpuInit); 

93 

94. 过 

注册 板 级 初始 化 函数 到 内 核 */ 

95; TclSetBoardEentry (&EVB_SetupBoard); 
96. 

97 . We 

注册 板 级 调试 打印 函数 到 内 核 */ 

98. TclSetTraceRoutine (&EVB UartlWritestr); 
59。 

L100 Pi 

注册 用 户 初始 化 函数 到 内 核 */ 

L101 TclSetUserEntry (gEthAppEntry); 
102. 

103. A 

启动 内 核 */ 

104. TclStartKernel (); 

105; 

106. return 1; 

107. } 

108. 

109. #endif 





11.4.2 ”实验 现象 











给 Colibri 评 估 板 供电 ， 利 用 网 线 把 评估 板 接 入 与 PC 相同 的 路 由 器 ， 也 可 以 直接 利用 网 线 把 评估 板 和 PC 相连 。 把 本 例 程 文件 编译 后 烧 录 到 评估 板 上 并 运行 ， 步 又 如 下 : 


























1) 在 命令 提示 符 窗口 输入 命令 : ping 192.168.1.118。 














2) 打开 浏览 器 ， 通 过 浏览 器 访问 http://192.168.1.118， 这 是 开发 板 默认 的 子 网 地 址 ， 我 们 编写 的 Web 服 务 器 程序 一 直 在 监听 80 端 口 。 


























读者 可 以 通过 浏览 器 手动 控制 板 载 LED 的 点 亮 和 熄灭 。 并 且 可 以 通过 底部 的 链接 访问 Trochili RTOS 官 方 网 站 和 微 博 ， 如 图 11-7 所 示 。 














画 管理 员 ; C:\Windows\system32\cmd.exe 


:NUSePsNLiuxX >ping 192.1t68.t1.1lt8 一 


HE 也 由头 二 : 


押 


Ping 192.168.1. 
192.168.1.118 
192.168.1.118 
192.168.1.118 
192.168.1.118 
192.168.1.118 
192.168.1.118 
和 天 
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192.168.1.118 


TTL=255 
TTL=255 
s TTL=255 
TTL=255 
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[BI<ims TTL=255 
时 | 本 <tims TTL=255 


a op rT 


IE 
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回回 回回 回回 回回 回 % 
尾村 本 村 村 村 村 二 


ONDA 


192.168.1.118 的 Ping 统计 信息 8 
| .数据 包 : 已 发 送 接收 ， 天 失 = 8 《@x 于 失 )， 
住 返 他 各 的 估计 时 间 ( 以 章 种 ; 
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GD 
ontrol-C 
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:sers\ 











图 11-6 ping 192.169.1.18 
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] LWIP WEB 服务 嚣 志 蒋 x 
€ © D192.158.1.118/html/html form action.asp 





感谢 使 用 飞鸟 RTOS 
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11-7 上 位 机 浏览 器 控制 板 载 LED 











